单片机与物联网 / 系统课时

实现自动重连

实现自动重连

Wi-Fi 断开后立即循环调用连接接口,容易造成高频重试、日志刷屏和功耗上升。本课用事件检测断线,再由主循环按指数退避安排重连,使 ESP32 在路由器重启、信号短暂中断等场景下能够稳定恢复联网。

学习目标

  • 使用 Wi-Fi 事件识别断开与重新获取 IP
  • 用递增重试间隔避免无休止的高频连接
  • 验证断网、恢复网络后的自动重连行为

把断线事件和重连动作分开

ESP32 的 Wi-Fi 事件回调适合记录“发生了什么”,不适合在回调里长时间阻塞或反复连接。更稳妥的做法是:事件回调只设置状态标记,主循环再根据 millis() 判断是否到达下一次重试时间。

ESP32 Wi-Fi 自动重连的退避流程

指数退避的目的不是让恢复变慢,而是在网络持续不可用时主动降低请求频率。网络一旦重新连上,就把重试计数清零,下一次断线仍从最短间隔开始。

实现带退避的自动重连

下面示例使用 Arduino-ESP32 的 WiFi.onEvent() 监听断开和获取 IP 事件,并关闭库自身的自动重连,避免与自定义策略重复工作。把示例中的网络名称和密码替换为你的测试网络。

cpp
#include <WiFi.h>

const char* WIFI_SSID = "YOUR_SSID";
const char* WIFI_PASSWORD = "YOUR_PASSWORD";

const uint32_t RETRY_BASE_MS = 1000;
const uint32_t RETRY_MAX_MS = 30000;

volatile bool disconnectedEvent = false;
volatile bool gotIpEvent = false;

uint8_t retryCount = 0;
bool waitingRetry = false;
uint32_t nextRetryAt = 0;

uint32_t currentRetryDelay() {
  uint8_t step = retryCount > 5 ? 5 : retryCount;
  uint32_t delayMs = RETRY_BASE_MS << step;
  return delayMs > RETRY_MAX_MS ? RETRY_MAX_MS : delayMs;
}

void onWiFiEvent(WiFiEvent_t event, WiFiEventInfo_t info) {
  // 回调只记录状态,避免在 Wi-Fi 事件线程中执行耗时重连。
  if (event == ARDUINO_EVENT_WIFI_STA_DISCONNECTED) {
    disconnectedEvent = true;
  } else if (event == ARDUINO_EVENT_WIFI_STA_GOT_IP) {
    gotIpEvent = true;
  }
}

void startConnection() {
  Serial.println("[WiFi] connecting...");
  WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
}

void scheduleRetry() {
  uint32_t delayMs = currentRetryDelay();
  nextRetryAt = millis() + delayMs;
  waitingRetry = true;

  Serial.printf("[WiFi] disconnected, retry in %lu ms\n",
                static_cast<unsigned long>(delayMs));

  if (retryCount < 6) {
    retryCount++;
  }
}

void setup() {
  Serial.begin(115200);
  WiFi.mode(WIFI_STA);
  WiFi.setAutoReconnect(false);
  WiFi.onEvent(onWiFiEvent);
  startConnection();
}

void loop() {
  if (gotIpEvent) {
    gotIpEvent = false;
    waitingRetry = false;
    retryCount = 0;
    Serial.print("[WiFi] connected, IP=");
    Serial.println(WiFi.localIP());
  }

  if (disconnectedEvent) {
    disconnectedEvent = false;
    if (WiFi.status() != WL_CONNECTED && !waitingRetry) {
      scheduleRetry();
    }
  }

  // 使用有符号差值比较,可正确跨越 millis() 的计数回绕。
  if (waitingRetry &&
      static_cast<int32_t>(millis() - nextRetryAt) >= 0) {
    waitingRetry = false;
    Serial.println("[WiFi] retrying...");
    WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
  }

  delay(10);
}

预期输出

text
[WiFi] connecting...
[WiFi] disconnected, retry in 1000 ms
[WiFi] retrying...
[WiFi] disconnected, retry in 2000 ms
[WiFi] retrying...
[WiFi] connected, IP=<IP>

<IP> 由当前路由器分配,实际值会不同。如果网络持续不可用,后续等待时间会继续增加并最终封顶在 30000 ms。

验证断线与恢复

先让 ESP32 正常连上 Wi-Fi,再关闭测试路由器或临时停用热点。串口应出现断开提示,且重试间隔逐步增大。随后恢复路由器,ESP32 应在下一次重试时重新获得地址,并把退避计数清零。

如果一直连接不上,先检查 SSID、密码和 2.4 GHz 网络是否可用,再观察是否持续收到断开事件。不要把重连写成无延迟的 while 循环,否则网络故障会让主循环长期被连接逻辑占用。

选择合理的重试策略

对交互设备,1 秒起步、30 秒封顶通常能兼顾恢复速度和网络压力;对电池设备,可以把上限提高到数分钟。若业务还依赖 MQTT、HTTP 等上层连接,应在 Wi-Fi 恢复并获得 IP 后再重建这些连接,而不是让多个协议各自无节制地重试。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现自动重连

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通