单片机与物联网 / 系统课时
实现自动重连
实现自动重连
Wi-Fi 断开后立即循环调用连接接口,容易造成高频重试、日志刷屏和功耗上升。本课用事件检测断线,再由主循环按指数退避安排重连,使 ESP32 在路由器重启、信号短暂中断等场景下能够稳定恢复联网。
学习目标
- 使用 Wi-Fi 事件识别断开与重新获取 IP
- 用递增重试间隔避免无休止的高频连接
- 验证断网、恢复网络后的自动重连行为
把断线事件和重连动作分开
ESP32 的 Wi-Fi 事件回调适合记录“发生了什么”,不适合在回调里长时间阻塞或反复连接。更稳妥的做法是:事件回调只设置状态标记,主循环再根据 millis() 判断是否到达下一次重试时间。

指数退避的目的不是让恢复变慢,而是在网络持续不可用时主动降低请求频率。网络一旦重新连上,就把重试计数清零,下一次断线仍从最短间隔开始。
实现带退避的自动重连
下面示例使用 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 后再重建这些连接,而不是让多个协议各自无节制地重试。
按自己的节奏,确认真正理解。