配网失败的本质
智能家居设备大多是 2.4GHz 单频、只支持 WPA2-PSK 的 IoT 模组，配网过程靠手机把 SSID 与密码通过广播报文或设备自带热点传给设备，再由设备自己去连路由器。失败通常不是设备坏了，而是频段、加密方式、隔离策略、SSID 字符串这四类环境条件与模组能力对不上。判断方向固定：先用手机热点做最小化验证，把环境因素隔离出去。
基本信息
| 常见频段 | 2.4GHz（多数 IoT 模组不支持 5GHz） |
|---|---|
| 加密支持 | 多为 WPA2-PSK(AES)；WPA3 需开过渡模式 |
| 配网方式 | 广播配网(SmartConfig)、SoftAP 直连、蓝牙辅助 |
| 二层要求 | 手机与设备须在同一 2.4G 二层网络内 |
| 阻断因素 | AP 隔离、客户端隔离会丢弃配网发现报文 |
典型使用场景
- 新设备首次入网，App 提示「未找到设备」或「配网超时」
- 双频合一 SSID 下反复失败：手机落在 5G，设备只能听 2.4G
- 企业或宿舍网络接入 IoT，需要单独 SSID 与接入策略
- 更换路由器或改密码后设备批量离线，需要重新配网
- 批量部署同型号设备，先确认单台成功再规模化
排查顺序
排查顺序
# 1 最小化验证：手机开热点，SSID 与密码只用字母数字
# 2 回目标路由器，单独建一个仅 2.4G 的 SSID 专供 IoT
# 3 SSID 用纯字母数字，密码 8~20 位，加密选 WPA2-PSK/AES
# 4 关闭 AP 隔离与客户端隔离，配网成功后再按需恢复
# 5 记录 App 返回的错误码，按厂商文档对号入座常见失败对照
| 现象 | 常见原因 | 处理 |
|---|---|---|
| App 搜不到设备 | 手机在 5G、设备仅在 2.4G | 手机切到 2.4G SSID 后重试 |
| 配到 99% 失败 | 密码含特殊字符或加密不兼容 | 改 WPA2-PSK/AES，密码用字母数字 |
| 首次成功重启失联 | 客户端隔离或 DHCP 未下发 | 关闭隔离，检查地址池余量 |
| 只有个别型号失败 | 模组固件或 SSID 长度限制 | 换更短的 SSID 或升级固件 |
企业网络里给 IoT 单开一个「仅 2.4G + WPA2 + 不隔离 + 独立地址池」的 SSID，比在办公 SSID 上迁就兼容性更省事；配网完成后再用 ACL 把这些终端限制在白名单范围内。
部分设备只认 SoftAP 配网（手机先连设备发射的热点，再填路由器信息），走广播配网必然失败；先看说明书确认它支持哪几种配网方式。