ESP32三种配网方式对比

qq_42733411

1091人浏览 · 2026-02-25 23:13:15

qq_42733411 · 2026-02-25 23:13:15 发布

ESP32 配网技术全景解析：原理、方案对比与实战实现

ESP32 作为主流物联网主控芯片，其配网（Provisioning）能力直接决定终端设备的易用性与部署效率。配网本质是将目标 WiFi 的 SSID 和密码安全、可靠、低门槛地传递给设备，使其完成首次联网。结合参考资料，ESP32 提供了三大主流配网范式：SoftAP 模式（Web 配网）、SmartConfig（一键配网）与 BLE 配网（BluFi），三者在交互逻辑、协议栈依赖、安全性及硬件兼容性上存在系统性差异。

一、问题解构：配网的核心挑战与设计维度

配网并非单纯的数据传输，而是一个多目标优化问题，需同时兼顾：

维度	关键诉求	典型约束示例
用户门槛	零技术背景用户可完成（如老人/儿童）	是否需手动连接热点？是否依赖特定 App？
网络依赖	配网过程是否需预置 WiFi 环境或手机热点	SmartConfig 依赖手机已连 WiFi；AP 模式需手机连 ESP32 热点
安全性	凭证不被中间人窃听、重放或明文暴露	SmartConfig 使用加密 UDP 报文；AP 模式需 HTTPS 或 Token 校验
可靠性	弱网、干扰、超时场景下仍能成功	SmartConfig 含重传与超时机制；AP 模式支持页面重载与表单校验
资源占用	嵌入式端内存/CPU 占用可控（尤其对 ESP32-C2 等精简型号）	BLE 配网需 NimBLE 协议栈；AP 模式需 WebServer + DNSServer

✅ 结论：无“银弹”方案，选型需基于产品形态——智能家居中控优先 AP+Web（高兼容），穿戴设备倾向 BLE（免 WiFi 依赖），量产设备常采用 SmartConfig + AP 双模兜底。

二、方案推演：三大配网模式深度对比

以下表格从技术实现、适用场景、代码复杂度、安全机制四维度横向对比：

特性	SoftAP 模式（Web 配网）	SmartConfig（含 AirKiss）	BLE 配网（BluFi）
工作原理	ESP32 启动 AP 热点 → 手机连接 → 访问 `
192.168.4.1` → 提交 WiFi 表单 → ESP32 切换 Station 模式	手机 App 将加密后的 SSID/PWD 通过 UDP 组播发送 → ESP32 的 WiFi 芯片监听并解密	手机通过 BLE 连接 ESP32 → GATT 服务写入 WiFi 凭证 → ESP32 解析后连接
依赖条件	手机支持 WiFi 连接（无需已连其他网络）	手机必须已接入目标 WiFi 网络（用于组播信道）	手机需开启蓝牙，无需 WiFi 环境
典型耗时	10–30 秒（含连接热点、加载网页、提交）	3–8 秒（纯广播，无握手开销）	5–15 秒（含 BLE 连接、MTU 协商、分包传输）
安全性	中（HTTP 明文风险）→ 需升级为 HTTPS 或添加 Token 校验	高（AES 加密凭证，仅 ESP32 芯片可解密）	高（BLE 链路层加密 + 应用层校验）
代码复杂度（ESP32）	★★★★☆（需集成 `WiFi.softAP()` + `DNSServer` + `WebServer` + HTML 页面）	★★☆☆☆（调用 `WiFi.beginSmartConfig()` + 事件循环监听）	★★★★☆（需配置 NimBLE/BLEDevice + GATT Server + BluFi Service）
典型应用场景	智能插座、环境监测仪（需通用浏览器访问）	米家/华为智选设备（微信扫码触发 SmartConfig）	TWS 耳机、医疗手环（无屏、无 WiFi 依赖）

三、核心方案实战：SoftAP Web 配网代码详解

以最通用的 SoftAP 模式为例，提供完整可运行的 Arduino-ESP32 C++ 实现（基于 ESP-IDF v5.x 兼容框架）：

#include <WiFi.h>
#include <DNSServer.h>
#include <WebServer.h>

// 配网状态机
enum ProvisionState { IDLE, AP_STARTED, WEB_SERVER_STARTED, CONFIG_RECEIVED, CONNECTING_WIFI };
ProvisionState state = IDLE;

// WebServer & DNS
WebServer server(80);
DNSServer dnsServer;
const char* apSSID = "ESP32-PROVISION";
const char* apPassword = "12345678";

void handleRoot() {
  String html = R"rawliteral(
<!DOCTYPE html>
<html>
<head><title>ESP32 配网</title><meta name="viewport" content="width=device-width, initial-scale=1"></head>
<body style="font-family:Arial; padding:20px;">
  <h2>🔧 ESP32 WiFi 配置</h2>
  <form action="/config" method="post">
    <label>WiFi 名称 (SSID):<br><input type="text" name="ssid" required style="width:100%; margin:5px 0;"></label><br>
    <label>WiFi 密码 (Password):<br><input type="password" name="password" style="width:100%; margin:5px 0;"></label><br>
    <button type="submit" style="margin-top:10px; padding:10px 20px;">✅ 连接网络</button>
  </form>
</body>
</html>
)rawliteral";
  server.send(200, "text/html", html);
}

void handleConfig() {
  if (server.hasArg("ssid") && server.hasArg("password")) {
    String ssid = server.arg("ssid");
    String password = server.arg("password");
    
    // 存储到 NVS（非易失存储）
    preferences.begin("wifi", false);
    preferences.putString("ssid", ssid);
    preferences.putString("password", password);
    preferences.end();

    server.send(200, "text/plain", "✅ 配置已保存！正在连接...");
    
    // 切换至 Station 模式并连接
    WiFi.mode(WIFI_STA);
    WiFi.begin(ssid.c_str(), password.c_str());
    
    state = CONNECTING_WIFI;
  } else {
    server.send(400, "text/plain", "❌ 缺少 SSID 或密码");
  }
}

void setup() {
  Serial.begin(115200);
  preferences.begin("wifi", false);
  
  // 检查是否已有配置
  if (preferences.getString("ssid", "") != "") {
    String ssid = preferences.getString("ssid");
    String pass = preferences.getString("password");
    Serial.printf("已存在配置，尝试连接 %s...
", ssid.c_str());
    WiFi.begin(ssid.c_str(), pass.c_str());
    return;
  }

  // 启动 SoftAP
  WiFi.softAP(apSSID, apPassword);
  IPAddress apIP(192, 168, 4, 1);
  WiFi.softAPConfig(apIP, apIP, IPAddress(255, 255, 255, 0));
  dnsServer.start(53, "*", apIP); // 捕获所有域名请求，指向本机
  
  server.on("/", HTTP_GET, handleRoot);
  server.on("/config", HTTP_POST, handleConfig);
  server.begin();
  
  Serial.println("✅ SoftAP 已启动，热点名：" + String(apSSID));
  Serial.println("👉 请用手机连接 WiFi '" + String(apSSID) + "'，然后访问 http://192.168.4.1");
}

void loop() {
  dnsServer.processNextRequest(); // 必须循环调用
  server.handleClient();

  // 连接状态监控
  if (state == CONNECTING_WIFI && WiFi.status() == WL_CONNECTED) {
    Serial.printf("🎉 成功连接 WiFi：%s，IP 地址：%s
", 
                  WiFi.SSID().c_str(), WiFi.localIP().toString().c_str());
    state = IDLE;
  }
}

🔍 关键说明：

DNSServer 实现“任意域名跳转”，解决用户输入 http://esp32.local 等无效域名时的失败问题；
preferences 使用 NVS（Non-Volatile Storage）持久化保存凭证，断电不丢失；
实际项目中应增加 SSID/Password 长度校验、特殊字符过滤、HTTPS 证书嵌入等工业级加固措施。