ESP32突然无法连接WiFi，求排查方案（VS+PlatformIO环境）

环境与依赖细节排查 #

• 清理PlatformIO全局缓存：删除.platformio目录（Windows路径C:\Users\<用户名>\.platformio，Linux/macOS路径~/.platformio），重新拉取依赖，避免依赖文件损坏导致的隐性兼容问题
• 回退PlatformIO插件版本：如果近期更新过VS Code的PlatformIO插件，降级到之前能正常工作的版本，插件更新可能引入未适配的问题
• 开启WiFi调试日志：在platformio.ini中添加build_flags = -DCORE_DEBUG_LEVEL=5，通过串口监视器查看连接过程中的具体错误码（如WIFI_CONNECT_FAIL_REASON对应的原因，包括认证失败、信道不匹配等）

WiFi网络参数与协议排查 #

• 确认路由器加密方式：检查路由器是否切换到WPA3加密，部分旧版ESP-IDF对WPA3支持有限；同时排查是否开启MAC地址过滤，即使能扫描到WiFi，MAC被拦截也会连接失败
• 固定WiFi信道与带宽：将路由器信道固定到1-11之间的常用信道，关闭160MHz带宽选项，部分ESP32模块对高带宽或自动信道的兼容性较差
• 验证SSID/密码合法性：避免使用含中文、特殊字符的SSID，确保密码长度和格式符合ESP32解析要求，可临时用纯英文数字的SSID/密码测试

硬件与干扰排查 #

• 排查供电稳定性：WiFi连接瞬间需要较大电流，更换短且带屏蔽的USB线，或外接3.3V/500mA以上的电源模块，排除供电不足导致的连接中断
• 规避无线干扰：将ESP32和路由器移至无遮挡、远离大功率无线设备（微波炉、蓝牙设备等）的位置，测试连接情况
• 检查天线接触：确认板载天线无松动，外接天线插紧，天线接触不良会导致信号可扫描但无法完成握手

系统底层状态排查 #

• 清除旧WiFi配置：在代码中添加esp_wifi_restore()并重启模块，清除存储的旧WiFi配置，避免残留配置干扰新连接
• 尝试静态IP连接：绕过路由器DHCP，手动给ESP32设置静态IP，测试是否能成功连接，排查DHCP分配异常问题
• 重置WiFi栈：在代码中先调用esp_wifi_stop()，再重新执行esp_wifi_init()、esp_wifi_set_mode()、esp_wifi_start()流程，修复可能异常的WiFi栈状态

极简代码验证 #

使用最基础的WiFi连接代码排除业务逻辑干扰：

#include <WiFi.h>

const char* ssid = "你的WiFi名称";
const char* password = "你的WiFi密码";

void setup() {
  Serial.begin(115200);
  WiFi.begin(ssid, password);

  int retry = 0;
  while (WiFi.status() != WL_CONNECTED && retry < 20) {
    delay(500);
    Serial.print(".");
    retry++;
  }

  if (WiFi.status() == WL_CONNECTED) {
    Serial.println("\n连接成功！");
    Serial.print("IP地址: ");
    Serial.println(WiFi.localIP());
  } else {
    Serial.println("\n连接失败，错误码: " + String(WiFi.status()));
  }
}

void loop() {}

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