ESP32 Arduino Wi-Fi配网模式深度剖析（含代码）

ESP32 Arduino Wi-Fi配网全攻略：从连不上网到“一碰即连”的实战进阶

你有没有遇到过这样的场景？

新买的智能插座插上电，指示灯狂闪却始终连不上Wi-Fi；
朋友送的温湿度传感器部署在阳台，换个路由器后彻底失联；
自己做的物联网项目烧录完程序，在实验室好好的，带到客户现场却死活连不上网络……

这些问题的背后，几乎都指向同一个核心环节——Wi-Fi 配网机制的设计是否健壮。

ESP32 凭借其双核处理器、Wi-Fi + 蓝牙双模通信和极低的成本，已成为嵌入式开发者的首选平台。而结合 Arduino 框架，更是让快速原型开发变得轻而易举。

但“能联网”和“会自适应地联网”，是两个完全不同的层次。

今天，我们就来拆解 ESP32 在 Arduino 环境下的各种 Wi-Fi 配网模式，不讲空话，只谈实战。目标很明确：让你的设备真正做到“一次烧录，随处部署”——无论换多少次路由器，都能自己搞定连接。

为什么标准WiFi.begin()不够用？

我们先来看一段最基础的代码：

WiFi.begin("MyHomeWiFi", "12345678"); while (WiFi.status() != WL_CONNECTED) { delay(500); Serial.print("."); }

这段代码看似没问题：设置 SSID 和密码，然后等待连接成功。但它藏着几个致命缺陷：

• 硬编码凭据→ 换个环境就得重新烧程序。
• 无限等待→ 如果网络不存在或信号弱，设备将卡死在这里。
• 无法恢复→ 用户改了路由器密码？设备直接变砖。

换句话说，这种写法适合调试，但绝不能用于产品。

真正的智能设备应该像智能手机一样：支持自动重连、允许用户重新配置、甚至可以通过手机一键配网。

那怎么实现？下面我们一步步升级。

第一关：STA 模式 + 自动重连（基础但必要）

核心思想：别死等，要有超时和重试

我们先优化最常用的 STA（客户端）模式。关键改进点有三个：
1. 设置连接超时（比如 15 秒）
2. 失败后尝试重连几次
3. 连接断开时能自动恢复

#include <WiFi.h> const char* ssid = "your_ssid"; const char* password = "your_password"; void connectToWiFi() { Serial.print("Connecting to "); Serial.println(ssid); WiFi.begin(ssid, password); int attempts = 0; while (WiFi.status() != WL_CONNECTED && attempts++ < 30) { delay(500); Serial.print("."); } if (WiFi.status() == WL_CONNECTED) { Serial.println("\nConnected!"); Serial.print("IP: "); Serial.println(WiFi.localIP()); } else { Serial.println("\nConnection failed."); } } void setup() { Serial.begin(115200); WiFi.mode(WIFI_STA); // 明确设置为 STA 模式 connectToWiFi(); } void loop() { // 定期检查连接状态，断线自动重连 if (WiFi.status() != WL_CONNECTED) { Serial.println("WiFi lost. Reconnecting..."); connectToWiFi(); } delay(5000); // 每 5 秒检测一次 }

✅效果提升：即使短暂断网也能自愈，避免“重启才能连上”的尴尬。

但这还不够。如果用户换了路由器呢？总不能每次都靠电脑串口重刷吧。

第二关：AP 模式 + Web 配置页（让用户自己填）

当设备连不上网络时，它需要一个“自救通道”。这时候，AP 模式就派上用场了。

我们可以让 ESP32 在启动失败后，摇身一变成为一个热点，比如叫ESP32_Setup，用户用手机连上去后打开浏览器，就能看到一个网页表单，输入新的 Wi-Fi 名称和密码，提交后保存并尝试连接。

这就像智能音箱进入“配网模式”时发出的那个热点。

实现步骤：

1. 尝试连接已知网络（从存储中读取）
2. 超时失败 → 启动软 AP
3. 启动 Web Server 提供配置界面
4. 接收用户提交的数据，保存并尝试连接

我们先看 AP 的基本实现：

#include <WiFi.h> #include <WebServer.h> const char* ap_ssid = "ESP32_Config"; const char* ap_password = "12345678"; // 必须至少8位 WebServer server(80); void setup() { Serial.begin(115200); WiFi.softAP(ap_ssid, ap_password); // 配置 AP 的 IP 地址为 192.168.4.1 IPAddress apIP(192, 168, 4, 1); WiFi.softAPConfig(apIP, apIP, IPAddress(255, 255, 255, 0)); Serial.print("AP IP: "); Serial.println(WiFi.softAPIP()); // 设置根路径响应 server.on("/", []() { String html = "<h2>Configure WiFi</h2>"; html += "<form method='post' action='/save'>"; html += "SSID: <input name='ssid'><br>"; html += "Password: <input name='password' type='password'><br>"; html += "<button type='submit'>Connect</button></form>"; server.send(200, "text/html", html); }); server.begin(); Serial.println("HTTP Server started at http://192.168.4.1"); } void loop() { server.handleClient(); // 处理网页请求 }

现在，当你手机连上ESP32_Config热点后，访问http://192.168.4.1就能看到配置页面。

不过目前还不完整——我们还没处理/save请求，也没有保存数据。

第三关：混合模式 + NVS 存储（真正的产品级方案）

要打造一个可量产的设备，必须解决两个问题：

1. 如何持久化保存 Wi-Fi 配置？
2. 如何实现“优先连已知网络，失败则开启配网”？

答案是：NVS（Non-Volatile Storage） + STA+AP 混合模式。

NVS 是 ESP32 提供的非易失性存储系统，比传统 EEPROM 更安全、寿命更长，特别适合频繁读写的场景。

完整流程如下：

[上电] ↓ [从 NVS 读取 SSID/密码] → [尝试 STA 连接] ↓ 否 ↓ 是 [连接成功？] ─────────→ [运行主程序] ↓ 是 [启动 AP + Web Server] ↓ [等待用户配置] ↓ [保存至 NVS → 重启连接]

下面是整合后的完整代码框架（关键部分已注释）：

#include <WiFi.h> #include <WebServer.h> #include <Preferences.h> // 使用 Preferences 替代原始 NVS C API，更简单 Preferences prefs; const char* default_ssid = "default_wifi"; const char* default_password = ""; WebServer server(80); String stored_ssid, stored_password; void loadCredentials() { prefs.begin("wifi", true); // 只读打开以读取 stored_ssid = prefs.getString("ssid", ""); stored_password = prefs.getString("pass", ""); prefs.end(); if (stored_ssid != "") { Serial.printf("Loaded credentials: SSID=%s\n", stored_ssid.c_str()); } else { Serial.println("No saved credentials found."); } } void saveCredentials(String ssid, String pass) { prefs.begin("wifi", false); prefs.putString("ssid", ssid); prefs.putString("pass", pass); prefs.end(); Serial.println("Credentials saved."); } void connectToWiFi() { if (stored_ssid == "") return; // 没有凭据就不试 Serial.print("Connecting to "); Serial.println(stored_ssid); WiFi.mode(WIFI_STA); WiFi.begin(stored_ssid.c_str(), stored_password.c_str()); int timeout = 15; while (WiFi.status() != WL_CONNECTED && timeout-- > 0) { delay(1000); Serial.print("."); } if (WiFi.status() == WL_CONNECTED) { Serial.println("\nConnected!"); Serial.print("IP: "); Serial.println(WiFi.localIP()); return; } Serial.println("\nConnection failed, starting config mode..."); } void handleRoot() { String html = "<h2>ESP32 WiFi Setup</h2>"; html += "<form action='/save' method='post'>"; html += "SSID: <input name='ssid' required><br>"; html += "Password: <input name='password' type='password'><br>"; html += "<button type='submit'>Save & Connect</button></form>"; server.send(200, "text/html", html); } void handleSave() { String new_ssid = server.arg("ssid"); String new_pass = server.arg("password"); saveCredentials(new_ssid, new_pass); // 回复并重启 server.send(200, "text/plain", "Saved! Restarting..."); delay(1000); ESP.restart(); } void startConfigPortal() { Serial.println("Starting Access Point..."); WiFi.mode(WIFI_AP_STA); // 注意：不是 WIFI_AP！要保留 STA 功能 WiFi.softAP("ESP32_Setup", "12345678"); IPAddress apIP(192, 168, 4, 1); WiFi.softAPConfig(apIP, apIP, IPAddress(255, 255, 255, 0)); server.on("/", HTTP_GET, handleRoot); server.on("/save", HTTP_POST, handleSave); server.begin(); Serial.print("AP IP: "); Serial.println(WiFi.softAPIP()); Serial.println("Go to http://192.168.4.1 to configure"); } void setup() { Serial.begin(115200); loadCredentials(); connectToWiFi(); if (WiFi.status() != WL_CONNECTED) { startConfigPortal(); } } void loop() { if (WiFi.status() != WL_CONNECTED) { server.handleClient(); } // 主逻辑可以放在这里（比如传感器采集） }

✅这才是工业级的做法：
- 凭据存在 NVS 里，掉电不丢
- 支持动态修改
- 断线可降级为配网模式
- 用户体验友好

终极武器：SmartConfig —— 手机 App 一键配网

有没有更酷的方式？当然有。

想象一下：你不需要手动连热点、也不用手动输入账号密码，只要在手机 App 里点一下“开始配网”，几秒钟后你的设备就自动连上了家里的 Wi-Fi。

这就是SmartConfig的魔力。

它是怎么做到的？

原理其实很巧妙：

1. 手机 App 连接到目标 Wi-Fi 网络
2. App 把 SSID 和密码通过 UDP 广播包发送出去（使用特定编码方式）
3. ESP32 处于混杂模式（Promiscuous Mode），监听所有无线帧
4. 捕获并解析这些特殊包，还原出 Wi-Fi 凭据
5. 自动连接

整个过程无需 ESP32 创建热点，也无需用户手动操作，真正实现“无感配网”。

如何启用？

#include <WiFi.h> void startSmartConfig() { WiFi.mode(WIFI_STA); WiFi.begin(); // 先启动 STA 模式 Serial.println("Waiting for SmartConfig..."); WiFi.disconnect(); WiFi.beginSmartConfig(); while (!WiFi.smartConfigDone()) { delay(500); Serial.print("."); } Serial.println("\nSmartConfig Success!"); Serial.printf("Connected to %s\n", WiFi.SSID().c_str()); Serial.printf("IP: %s\n", WiFi.localIP().toString().c_str()); } void setup() { Serial.begin(115200); startSmartConfig(); } void loop() { // 已连接，执行主任务 }

⚠️注意事项：
- 手机必须连接到目标 Wi-Fi（不能用流量）
- 建议配合物理按键触发（如长按 5 秒进入 SmartConfig 监听）
- 周边干扰大时可能失败，建议提供 fallback 到 AP 模式

实战建议：别再踩这些坑！

我在多个项目中踩过的雷，总结成几条血泪经验：

❌ 错误做法 vs ✅ 正确姿势

🛠 推荐增强功能

1. LED 状态指示：
   - 快闪：正在尝试连接
   - 慢闪：等待配网
   - 常亮：已联网

2. 按键触发配网：
   cpp #define BUTTON_PIN 0 if (digitalRead(BUTTON_PIN) == LOW) { delay(50); // 去抖 if (digitalRead(BUTTON_PIN) == LOW) { delay(5000); // 长按5秒判断 if (digitalRead(BUTTON_PIN) == LOW) { startConfigPortal(); // 或 SmartConfig } } }

3. 多模式 fallback：
   - 先尝试 STA
   - 失败 → SmartConfig
   - 再失败 → AP Portal

写在最后：配网不是功能，而是用户体验

很多开发者把 Wi-Fi 配网当成一个技术任务去完成，但实际上，它是用户对产品的第一印象。

一个连不上网的智能设备，不管功能多强大，都会被当作“坏的”。

所以，请务必重视以下三点：

1. 默认行为要聪明：不要让用户做选择题。
2. 出错要有出路：提供清晰的恢复路径。
3. 交互要直观：能用 App 就别让用户输密码。

掌握 STA、AP、混合模式、SmartConfig 四种手段，并根据产品定位灵活组合，你就能做出真正“傻瓜式”的智能硬件。

下次当你设计一个新的 IoT 设备时，不妨问自己一句：

“如果我妈要用这个设备，她能不能自己搞定配网？”

如果答案是“能”，那你已经赢了一半。

如果你在实现过程中遇到了其他挑战，欢迎在评论区分享讨论。