NodeMCU V3接入WiFi后频繁复位的原因排查求助

• 使用优质Micro-USB将NodeMCU V3连接至笔记本电脑，运行LED闪烁、传感器读取等基础代码时一切正常
• 运行WiFi连接代码时，NodeMCU频繁与电脑断开重连（已通过设备管理器确认）
• 串口监视器要么显示乱码（类似波特率错误的方块符号），要么因设备未连接无法打开
• 必须按住复位按钮才能上传之前的正常代码
• 已排除线缆故障和MCU硬件损坏，怀疑与WDT（看门狗定时器）有关，但不确定原因

涉事WiFi连接代码 #

#include <ESP8266WiFi.h>

const char* ssid = "WiFiSSID";
const char* password = "WiFiPassword";

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

    WiFi.begin(ssid, password);

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

    Serial.println("");
    Serial.println("WiFi connected");
    Serial.println("IP address: ");
    Serial.println(WiFi.localIP());
}

void loop() {
    // Your main code goes here
}

核心原因 #

1. 看门狗定时器（WDT）触发复位 #

ESP8266的硬件看门狗会监测系统是否长时间无响应，你的代码中while(WiFi.status() != WL_CONNECTED)是无超时的死循环：

• 如果WiFi信号差、SSID/密码错误，或者路由器拒绝连接，这个循环会一直阻塞，看门狗会判定系统死机，触发强制复位
• 基础代码没有长时间阻塞的逻辑，所以不会触发看门狗

2. WiFi启动时供电不足 #

ESP8266开启WiFi模块时，电流会从待机的几十mA飙升至200mA以上：

• 即使基础代码能正常运行，高负载的WiFi启动会暴露电脑USB口供电能力不足、线缆压降过大的问题，导致MCU电压不稳，触发重启或断开连接

3. 串口波特率不匹配 #

串口乱码大概率是串口监视器波特率与代码中Serial.begin(115200)不一致，或者MCU重启过程中波特率临时波动导致。

解决步骤 #

1. 修改代码，避免死循环触发看门狗 #

给WiFi连接添加超时逻辑，并在主循环中定期喂狗：

#include <ESP8266WiFi.h>

const char* ssid = "WiFiSSID";
const char* password = "WiFiPassword";
const unsigned long WIFI_CONNECT_TIMEOUT = 20000; // 20秒连接超时

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

    WiFi.begin(ssid, password);
    unsigned long startMillis = millis();

    while (WiFi.status() != WL_CONNECTED) {
        delay(500);
        Serial.print(".");
        // 超时判断，避免无限阻塞
        if (millis() - startMillis > WIFI_CONNECT_TIMEOUT) {
            Serial.println("\nWiFi连接超时，退出等待");
            break;
        }
        // 手动喂看门狗，防止触发复位
        ESP.wdtFeed();
    }

    if (WiFi.status() == WL_CONNECTED) {
        Serial.println("");
        Serial.println("WiFi connected");
        Serial.println("IP address: ");
        Serial.println(WiFi.localIP());
    }
}

void loop() {
    // 主循环定期喂狗，保证系统稳定
    ESP.wdtFeed();
    delay(1000);
}

2. 排查供电问题 #

• 更换至电脑后置USB口（供电通常比前置更稳定）
• 若仍有问题，使用带外部供电的USB hub给NodeMCU供电
• 确认Micro-USB线缆长度不超过1米，过长会导致电压压降过大

3. 修正串口设置 #

• 确保串口监视器的波特率设置为115200，与代码一致
• 每次MCU重启后，关闭并重新打开串口监视器，避免连接异常

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