ESP32搭载WiFiManager首次连接后无法可靠重连，如何解决？

问题分析 #

你当前的代码在loop中每次检测到WiFi断开就直接调用autoConnect，但autoConnect是阻塞式函数，频繁调用会导致ESP32 WiFi栈资源冲突，进而出现卡顿、无法启动WiFi或无限重试的情况。同时默认的WiFiManager参数缺少合理的重连超时与回退逻辑，也是问题诱因。

解决方案 #

1. 配置WiFiManager重连与回退参数 #

通过设置连接超时、配置门户超时，以及启用旧连接状态清理功能，让重连逻辑更稳定：

• 限制单次WiFi连接尝试的超时时间，避免无限等待
• 配置门户无人操作时自动超时（可选）
• 强制清理旧连接状态后再尝试新连接

2. 优化loop中的重连逻辑 #

避免每次loop触发重连，添加非阻塞延迟控制重试频率；检测到断连时先清理当前WiFi状态，再执行重连操作。

修改后的代码 #

#include <WiFiManager.h>

WiFiManager wm;
unsigned long lastReconnectAttempt = 0;
const unsigned long reconnectDelay = 5000; // 5秒重试间隔

void setup() {
  Serial.begin(115200);

  // 配置WiFiManager核心参数
  wm.setConnectTimeout(20); // 单次WiFi连接超时时间（秒）
  wm.setConfigPortalTimeout(30); // 配置门户超时自动退出（秒）
  wm.setBreakAfterConfig(true); // 新配置生效后断开旧连接
  wm.setCleanConnect(true); // 重连前清理旧连接状态

  bool res = wm.autoConnect("ESP32_AP", "12345678");

  if(!res) {
    Serial.println("初始连接失败，正在重启...");
    ESP.restart();
  } else {
    Serial.println("已成功连接WiFi :)");
  }
}

void loop() {
  if(WiFi.status() != WL_CONNECTED) {
    unsigned long currentMillis = millis();
    // 非阻塞延迟控制重试频率，避免频繁调用阻塞函数
    if(currentMillis - lastReconnectAttempt >= reconnectDelay) {
      lastReconnectAttempt = currentMillis;
      Serial.println("WiFi断开，正在尝试重连...");
      
      // 彻底清理当前WiFi连接状态
      WiFi.disconnect(true);
      // 尝试重连，失败则自动启动配置门户
      bool res = wm.autoConnect("ESP32_AP", "12345678");
      
      if(!res) {
        Serial.println("重连失败，将重启设备...");
        delay(1000);
        ESP.restart();
      } else {
        Serial.println("重连成功 :)");
      }
    }
  }
  // 此处添加你的业务逻辑代码
}

关键修改点说明 #

• 非阻塞重试延迟：用millis()实现时间间隔控制，避免loop中频繁调用autoConnect导致的资源占用
• WiFi状态清理：重连前调用WiFi.disconnect(true)彻底重置WiFi栈，避免旧连接残留引发冲突
• 参数配置：
  • setConnectTimeout(20)：超时后自动触发配置门户，防止无限等待
  • setCleanConnect(true)：确保每次重连都是全新的连接尝试
  • setConfigPortalTimeout(30)：无人操作时自动重启，避免设备长时间停留在配置状态

额外建议 #

• 测试阶段可临时启用wm.resetSettings()清除旧WiFi凭据，确保测试环境干净
• 若仍有卡顿，可在重连前添加WiFi.mode(WIFI_OFF)，延迟100ms后切换回WIFI_STA，彻底重置WiFi模块

内容的提问来源于stack exchange，提问作者nima