OctoPi/树莓派3B WiFi网络配置失败：DHCP与静态IP均无法生效求助

嗨，我之前折腾OctoPi的时候也碰到过几乎一模一样的WiFi问题，试了好几种方法才搞定，给你分享几个亲测有效的排查和修复步骤，应该能帮你解决：

一、先从基础硬件和环境排查 #

• 先确认树莓派3B的内置WiFi模块没故障：可以临时插个USB WiFi适配器试试，如果适配器能正常连网，那大概率是内置模块出问题了（比如虚焊或者硬件损坏）；
• 尽量靠近路由器测试，排除信号太弱导致的连接失败；
• 检查WiFi密码是否包含特殊字符（比如中文、全角符号、特殊符号组合），OctoPi的配置文件对这类字符支持很差，建议先换成纯英文+数字的密码试试。

二、重置dhcpcd服务与配置 #

dhcpcd出错是这类问题的重灾区，重置配置往往能解决很多莫名的问题：

1. 先停止dhcpcd服务：

   sudo systemctl stop dhcpcd
   

2. 备份原配置文件（以防万一）：

   sudo cp /etc/dhcpcd.conf /etc/dhcpcd.conf.bak
   

3. 恢复成默认配置：

   sudo cp /usr/share/dhcpcd/dhcpcd.conf.example /etc/dhcpcd.conf
   

4. 重启dhcpcd和网络服务：

   sudo systemctl restart dhcpcd
   sudo systemctl restart networking
   

三、检查wpa_supplicant配置的正确性 #

octopi-wpa-supplicant.txt的格式很严格，一点点错误都会导致连接失败：

• 打开文件确认SSID和密码的格式，正确的写法应该是这样（注意引号是英文半角，不要有多余空格）：

  network={
      ssid="你的WiFi名称"
      psk="你的WiFi密码"
      key_mgmt=WPA-PSK
  }
  

• 另外要注意：树莓派3B只支持2.4GHz频段的WiFi，如果你连的是5GHz的网络，肯定会失败，记得切换到2.4GHz的WiFi信号。

四、静态IP配置的正确姿势 #

如果一定要用静态IP，别只改IP地址，网关和DNS必须同步配置正确：

• 在/etc/dhcpcd.conf里添加以下内容（替换成你自己的网段信息）：

  interface wlan0
  static ip_address=192.168.1.100/24  # 这里的IP要和路由器网段一致
  static routers=192.168.1.1          # 路由器的IP地址
  static domain_name_servers=192.168.1.1 8.8.8.8  # DNS服务器，可填路由器IP或公共DNS
  

• 配置完成后一定要重启dhcpcd服务生效。

五、系统与固件更新 #

老版本的系统或固件可能存在WiFi兼容性问题：

• 更新系统包：

  sudo apt update && sudo apt upgrade -y
  

• 更新树莓派固件（注意：这个操作有小概率导致系统异常，建议先备份重要数据）：

  sudo rpi-update
  

• 重启树莓派后再测试WiFi连接。

六、查看日志定位深层问题 #

如果以上方法都没用，看看日志找线索：

• 查看dhcpcd的详细错误日志：

  journalctl -u dhcpcd
  

• 查看WiFi模块的初始化日志：

  dmesg | grep wlan0
  

日志里会有更具体的错误信息，比如“拒绝连接”“找不到网络”之类的，能帮你精准定位问题。

我当时是因为WiFi密码里加了个全角的感叹号，导致wpa_supplicant识别失败，换成半角符号就搞定了，你可以先从简单的检查开始试～

备注：内容来源于stack exchange，提问作者Leder