1. WiFi 配网基础概念
做物联网这些年，我见过太多工程师在配网环节栽跟头。明明设备硬件没问题，WiFi 模块也正常，就是连不上路由器。说白了，很多问题都出在没搞懂配网的本质。
今天咱们先把基础打牢。什么是 WiFi 配网？为什么需要它？常见的配网模式有哪些？我把这些年的经验揉碎了讲给你听。
1.1 什么是 WiFi 配网
WiFi 配网，就是把路由器的 SSID 和密码，告诉给一个还没有联网能力的设备。
你想想看，一个刚出厂的智能插座，它没有屏幕、没有键盘，怎么知道你家路由器的名字和密码？配网就是解决这个问题的过程。
核心要点：配网的本质是「信息传输」—— 把 WiFi 凭证从手机/网关，安全地传递给目标设备。
我在项目中遇到过不少新手，以为配网就是设备自动连上 WiFi。其实不是。设备在配网前，连最基本的网络信息都没有，需要借助外部手段「喂」给它。
1.2 三种主流配网模式
目前市面上常见的配网模式有三种。我按自己的使用频率排个序：
| 配网模式 | 原理 | 典型场景 | 我的评价 |
|---|---|---|---|
| SmartConfig | 手机通过广播/组播发送加密的 WiFi 信息，设备监听抓包 | ESP8266/ESP32 系列 | 简单快速，但兼容性看芯片 |
| SoftAP | 设备自己开热点，手机连上去后发送 WiFi 信息 | 几乎所有 WiFi 模组 | 最通用，但用户体验略差 |
| 蓝牙辅助 | 通过 BLE 通道传输 WiFi 凭证 | 双模设备（WiFi+BLE） | 体验最好，但硬件成本高 |
SmartConfig 模式
这种模式我最早接触是在乐鑫的芯片上。手机把 SSID 和密码编码到 UDP 包的长度或内容里，设备处于混杂模式监听，抓到包后解码。
优点很明显：操作简单，手机点几下就行。缺点也突出：不是所有路由器都支持组播/广播转发，有些企业级 AP 会直接过滤掉。
我的经验：SmartConfig 在家庭路由器上成功率很高，但在商场、酒店等复杂网络环境下，经常失败。如果你做的是消费类产品，优先考虑这个方案。
SoftAP 模式
设备先把自己变成一个热点（AP），手机连上这个热点，然后通过 HTTP 或 Socket 把 WiFi 信息发过去。设备收到后，切换回 Station 模式去连路由器。
这种方式最可靠，几乎 100% 能成功。但用户体验嘛…… 手机要断开当前 WiFi，连到设备的热点，配完再切回来。我早期做项目时，用户投诉最多的就是「配网太麻烦」。
注意：设备做 SoftAP 时，热点名称（SSID）一定要有辨识度，比如 "SmartBulb_XXXX"。别用默认的 "ESP_XXXX"，用户根本分不清哪个是自己的设备。
蓝牙辅助模式
这是目前体验最好的方案。设备同时支持 WiFi 和 BLE，手机通过蓝牙把 WiFi 信息传过去，设备收到后自动连接。整个过程用户不需要切换网络。
我去年做的一个智能门锁项目就用的这个方案。配网成功率从 SoftAP 的 95% 提升到了 99.5% 以上。代价是多了颗蓝牙芯片，成本涨了大概 3 块钱。
1.3 配网流程全景图
下面这张图，是我自己总结的配网全流程。不管用哪种模式，核心步骤都跑不出这个框架。
这个流程看起来简单，但每个阶段都有坑。我挑几个常见的说说：
- 准备阶段：设备上电后要尽快进入配网模式，别让用户等太久。我习惯用 3 秒内完成初始化。
- 传输阶段：SmartConfig 模式下，手机和设备要在同一个信道。有些路由器会跳频，导致设备收不到包。
- 连接阶段：设备连路由器时，要处理 DHCP 超时、DNS 解析失败等情况。别只做一次尝试。
- 确认阶段：设备连上路由器后，最好主动向服务器发个心跳，证明「我真的在线了」。
我曾经踩过的坑：有个项目，配网成功率一直卡在 85%。查了三天，发现是设备在连接阶段只尝试了一次，路由器响应慢一点就超时了。改成重试 3 次后，成功率直接到 97%。
1.4 配网模式怎么选
这个问题没有标准答案。我一般按这个逻辑判断：
- 成本敏感、单 WiFi 芯片：用 SmartConfig，用户体验好，但要做好兼容性测试。
- 可靠性优先、不介意操作步骤：用 SoftAP，虽然麻烦点，但几乎不会失败。
- 预算充足、追求极致体验：上蓝牙辅助，配网成功率最高，用户无感。
嗯，这里要注意：不管选哪种模式，都要在设备端做好配网超时处理。我见过有些设备进入配网模式后，如果用户不操作，就一直卡在那里，电池都耗光了。设置一个 5 分钟的超时，超时后自动休眠，这才是负责任的做法。
好了，配网基础就讲到这里。这些概念搞清楚了，后面排查连接断开问题时，你才能快速定位到是哪个环节出了岔子。