树莓派无法连接WiFi时应如何排查？

一、检查无线网卡状态

首先执行 ifconfig 命令查看是否存在 wlan0 接口。若未显示，通过 sudo ifconfig -a 确认网卡驱动是否正常加载，缺失该接口可能表明硬件故障或驱动未启用。

二、验证WiFi名称与密码

树莓派对特殊字符敏感，避免在SSID中使用下划线(_)或中划线(-)。建议用手机热点测试，并在 /etc/wpa_supplicant/wpa_supplicant.conf 中检查密码格式是否正确。

network={
ssid="TestWiFi
psk="password123
priority=1
}

三、检查网络配置文件

按顺序排查以下配置文件：

1. 编辑 dhcpcd.conf 确认静态IP配置格式正确
2. 检查 /etc/network/interfaces 是否禁用DHCP
3. 使用 wpa_cli -i wlan0 reconfigure 重载配置

四、排查DHCP与静态IP冲突

若配置静态IP后仍无法联网：

• 确认网关与DNS地址与路由器一致
• 测试ping 8.8.8.8 判断是否为DNS故障
• 删除临时IP分配文件 sudo rm /var/lib/dhcpcd5/*

五、检测无线射频状态

执行 rfkill list 检查无线信号是否被禁用，若显示 Soft blocked: yes，通过 rfkill unblock all 解除锁定。

六、排除路由器兼容性问题

部分5GHz频段路由器存在兼容问题：

• 强制使用2.4GHz频段进行测试
• 更换不同品牌路由器验证
• 检查路由器MAC过滤规则

通过硬件状态检查、配置文件验证、网络模式调试的三层排查法，可解决90%以上的树莓派WiFi连接异常。建议优先使用手机热点测试缩小问题范围，重点关注静态IP配置格式与特殊字符限制。