如何在无头模式下配置树莓派连接WiFi？配置失败如何排查

1 优先解决SD卡分区残留导致的Imager烧录报错问题 #

你遇到的RPI Imager校验时报无法创建FAT32分区，90%是SD卡残留旧分区表导致的，按以下步骤清理后再烧录：

• Windows操作：
  按下Win+R输入diskpart回车，依次执行以下命令：

  list disk
  # 找到你的SD卡对应的磁盘编号（注意不要选错硬盘）
  select disk X
  # 清除整个磁盘的分区表
  clean
  exit
  

  清理完成后不要手动给SD卡新建分区，直接打开RPI Imager烧录系统即可，可解决大部分分区报错问题。
• Linux/macOS操作可直接用磁盘工具对SD卡执行全空间抹除，格式选FAT32即可。

2 排查手动创建配置文件的常见错误 #

2.1 文件名后缀错误 #

Windows默认隐藏已知文件扩展名，很多用户创建的ssh实际是ssh.txt、wpa_supplicant.conf实际是wpa_supplicant.conf.txt，树莓派无法识别：

• 先打开Windows资源管理器的「查看」选项，勾选「文件扩展名」，确认两个配置文件没有任何多余后缀。

2.2 文件编码错误 #

用Windows自带记事本保存的配置文件默认是UTF-8带BOM格式，树莓派无法正常读取：

• 推荐用Notepad++等编辑器保存文件，编码选择「UTF-8 无BOM」，换行符选择「Unix(LF)」。

2.3 适配新版Raspberry OS (Bookworm)的强制要求 #

2022年之后发布的Bookworm版本Raspberry OS取消了默认的pi用户，仅放ssh和wpa_supplicant.conf无法完成启动：

• 需要在boot分区额外新建userconf.txt文件，内容格式为：用户名:加密后的密码
• 加密密码可通过openssl passwd -6 你的密码命令生成，例如用户名为pi、密码为raspberry的配置示例：

  pi:$6$xyz$abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/
  

3 修正wpa_supplicant.conf配置问题 #

• 确认country字段和你所在地区的WiFi规范一致：国内用户请改为CN，否则会被系统屏蔽合规外的WiFi频段，无法搜到信号
• 确认你的WiFi加密方式为WPA2/WPA3个人级，不支持WEP、企业级802.1x加密
• 老款树莓派（3B、Zero W等）仅支持2.4G WiFi，请将你的路由器2.4G和5G WiFi的SSID分开设置，避免树莓派尝试连接不支持的5G信号
• 若SSID或密码包含特殊字符（如双引号、反斜杠），需要加反斜杠\转义

4 兜底排查方案 #

如果以上操作全部完成仍无法连接，可临时外接HDMI显示器启动树莓派，查看启动日志中的WiFi相关报错，或登录系统后执行以下命令定位问题：

• 扫描可用WiFi：iw dev wlan0 scan | grep SSID
• 查看WiFi服务日志：journalctl -u wpa_supplicant.service -f
• 查看网卡状态：ip a show wlan0

内容的提问来源于stack exchange，提问作者CodingBiology