适用于产品: 幻尔科技 树莓派5系列产品
涉及模块: 网络配置 / 无线网卡区域码
核心标签: 通用 5gwifi 区域码 iw-reg
一、故障现象
在切换局域网模式时，无法连接自家的网络，机器自动回退到AP热点模式。机器人的 WiFi 列表里能看到自己家的 2.4G 网络，也能看到周围其他 5G 网络，但唯独搜不到自家路由器的 5G 网络。手动连接时报错：
nmcli dev wifi connect "WiFi名" password "密码"
Error: No network with SSID 'WiFi名' found.
二、常见原因
系统无线区域代码（regulatory domain）与当地 WiFi 环境不匹配。区域代码决定了 5G 各频段信道是否可用：
- 部分区域代码（如 HK / DFS-ETSI）下，5G 高频段（149~165 信道）受限，扫描不到该频段上的网络
- 自家路由器 5G 恰好工作在受限频段（如 161 信道），就会只看到邻居的 5G、看不到自家的
- 改成中国区域代码（CN）后，5G 全频段恢复可见
三、排查步骤
1. 查看当前区域代码
（1）执行：
iw reg get
（2）看输出第一段 global 行，例如 country HK: DFS-ETSI，说明当前区域是 HK，5G 高频段受限。
2. 确认自家 5G 网络的信道
（1）登录路由器管理页面，找到 5G 无线设置，记下信道号。
（2）如果信道在 149~165 区间且当前区域代码不是 CN，与本帖故障现象吻合。
四、解决方案
1. 临时设置区域代码为 CN（立即生效）
（1）执行：
sudo iw reg set CN
（2）确认已生效：
iw reg get
看到 global 行为 country CN: DFS-FCC 即成功。
（3）重新扫描 WiFi：
nmcli dev wifi rescan
sleep 5
nmcli dev wifi list
此时自家 5G 网络应出现在列表中。
（4）正常连接：
nmcli dev wifi connect "WiFi名" password "密码"
铁律：sudo iw reg set CN 只对本次开机生效，重启后恢复原区域代码。需要长期生效请继续执行方案 2。
验证：连接成功后执行 nmcli -t -f active,ssid dev wifi 确认已连上目标网络，并 ping 网关测试网络连通性。
2. 永久设置区域代码（重启不丢）
（1）编辑区域配置文件：
sudo raspi-config nonint do_wifi_country CN
（2）重启后区域代码即为 CN。
3. 区域代码正确仍搜不到时的补充检查
（1）确认路由器 5G 没有勾选隐藏网络（不广播 SSID）。如果勾选了，改用隐藏网络直连：
nmcli dev wifi connect "WiFi名" password "密码" hidden yes
（2）确认 5G 信道不是 DFS 信道（52/56/60/64）。DFS 信道需要雷达检测，部分设备扫描缓慢或不可见，可到路由器把 5G 信道改为 36/40/44/48 或 149/153/157/161 再试。
注意：修改路由器信道后机器人可能短暂断网，属正常现象，重新扫描即可。
完整链路检查：区域代码（iw reg get）→ 路由器信道与广播设置 → 重新扫描（nmcli dev wifi rescan）→ 连接 → 验证连通，按此顺序排查可避免反复试错。
五、延伸参考
- 2.4G 网络通常不受区域代码限制，这就是为什么故障时 2.4G 一直可见
- 5G 信道常识：36~48 信道为非 DFS 常规信道；149~165 为高频段信道，不同区域代码对高频段的开放程度不同
- 连接新网络后机器人 IP 会变化（DHCP 重新分配），远程 SSH / App 连接前请先确认新 IP