江平舟1. ESP32 初次开机自动配置WiFi的核心需求
当拿到一块全新的ESP32开发板时，最迫切的需求就是让它快速连上WiFi网络。传统做法是通过串口手动输入SSID和密码，这种方式在批量部署或产品化场景中存在明显短板。想象一下，如果你需要配置100台设备，或者把产品卖给不懂技术的终端用户，这种交互方式就变得极其低效。
自动配置WiFi的核心价值在于实现"开箱即用"体验。设备首次上电时，会自动进入配置模式（通常表现为启动一个AP热点），用户通过手机或电脑连接这个热点后，在引导页面输入目标WiFi信息。配置完成后，ESP32会保存这些凭证，后续重启时直接连接目标网络，无需重复配置。
这种机制在智能家居设备中尤为常见。比如你买了一个智能灯泡，第一次使用时手机APP会提示你配置网络，整个过程可能只需要1分钟。背后的技术实现，正是我们今天要探讨的内容。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 实现方案选型与技术对比
2.1 常见自动配网方案对比
在ESP32生态中，主要有三种主流的自动配网实现方式：
-
SmartConfig（智能配置）
- 原理：通过手机APP发送包含WiFi信息的UDP广播包
- 优点：无需额外硬件，TI专利技术
- 缺点：依赖特定APP，安卓/iOS兼容性问题
-
WiFi Manager（网页配网）
- 原理：ESP32启动AP热点，用户连接后访问配置页面
- 优点：跨平台兼容性好，无需专用APP
- 缺点：需要手动切换设备WiFi
-
蓝牙配网（BLE Provisioning）
- 原理：通过蓝牙服务传输WiFi配置
- 优点：低功耗，可加密传输
- 缺点：开发复杂度较高
方案对比表：
| 方案特性 | SmartConfig | WiFi Manager | 蓝牙配网 |
|---|---|---|---|
| 开发难度 | 低 | 中 | 高 |
| 用户友好度 | 中 | 高 | 高 |
| 跨平台支持 | 差 | 优秀 | 优秀 |
| 安全性 | 低 | 中 | 高 |
| 典型应用场景 | 早期智能设备 | 开源项目 | 商业产品 |
2.2 为什么选择WiFi Manager方案
对于大多数开发者而言，WiFi Manager（https://github.com/tzapu/WiFiManager）是最平衡的选择。这个开源库已经过多年迭代，具有以下优势：
- 内置Web服务器，提供响应式配置页面
- 支持多网络配置和优先级设置
- 自动保存凭证到Flash，支持断电记忆
- 提供超时回退和重试机制
- 可自定义AP名称和IP地址
更重要的是，它不依赖任何第三方服务或APP，完全在本地运行，这对数据隐私要求高的场景尤为重要。
3. 完整实现步骤详解
3.1 开发环境准备
首先确保你的开发环境已经就绪：
-
硬件准备
- ESP32开发板（推荐ESP32-WROOM-32）
- Micro USB数据线
- 稳定的5V电源
-
软件依赖
- Arduino IDE 2.0+（需安装ESP32支持包）
- 安装WiFiManager库：
bash复制
arduino-cli lib install WiFiManager - 可选：VS Code + PlatformIO插件
-
基础电路连接
- 将开发板通过USB连接电脑
- 确保串口驱动已正确安装
- 建议外接LED指示灯（GPIO2）用于状态显示
3.2 核心代码实现
创建新的Arduino项目，完整代码如下：
cpp复制#include <WiFiManager.h>