ESP32连家用WiFi返回WL_IDLE_STATUS失败可正常连接手机热点

• 故障现象：设备无法连接家用WiFi，但可正常连接手机热点
• 初步排查：编写串口打印程序输出WiFi连接状态码，连接家用WiFi时反复返回WL_IDLE_STATUS（状态值0）；尝试添加WiFi.setMinSecurity(WIFI_AUTH_WPA2_PSK);配置最低安全等级为WPA2_PSK，问题未解决

测试代码 #

#include <Arduino.h>
#include <WiFi.h>

const char* meuSSID = "asdfgh";
const char* meuPASS = "12345678";

void setup() {
  Serial.begin(9600);
  
  WiFi.mode(WIFI_STA);
  WiFi.begin(meuSSID , meuPASS);

  int status = WiFi.status();
  while (status != WL_CONNECTED) {
    Serial.print("status:");
    Serial.println(status);

    Serial.print("ip:");
    Serial.println(WiFi.localIP());

    Serial.println(WiFi.macAddress());

    Serial.println("Conectando...");
    status = WiFi.status();
    delay(1000);
  }

  Serial.println(WiFi.localIP());
}

void loop() {
  Serial.println("Oi");
  delay(1000);
}

串口输出对比 #

连接家用WiFi（持续循环，连接失败） #

status:0
ip:0.0.0.0
24:6F:28:B0:28:6C
Conectando...
status:0
ip:0.0.0.0
24:6F:28:B0:28:6C
Conectando...

(...)

连接手机热点（可正常获取IP，连接成功） #

status:6
ip:0.0.0.0
24:6F:28:B0:28:6C
Conectando...
status:6
ip:192.168.43.1
24:6F:28:B0:28:6C
Conectando...
192.168.43.1

排查解决方向 #

WL_IDLE_STATUS代表WiFi处于空闲状态、未启动连接流程，能正常连接手机热点说明ESP32硬件、基础代码逻辑无故障，问题集中在家用路由器配置与ESP32 WiFi库的兼容性上，按以下优先级排查即可：

• 核对WiFi频段与信道：普通ESP32仅支持2.4G频段WiFi，无法识别纯5G频段的WiFi信号；2.4G频段需设置为1-13信道，若路由器开启14信道会导致ESP32无法搜索到网络、触发连接，建议将2.4G信道固定为1/6/11三个通用非重叠信道。
• 检查SSID与密码格式：若家用WiFi名称、密码包含中文、全角符号、特殊转义字符或首尾空格，ESP32 WiFi库解析时会出现异常，可临时将SSID改为纯英文字符、密码改为字母+数字的常规组合测试。
• 调整路由器安全配置：部分家用路由器默认开启WPA3加密、强制PMF（管理帧保护）、MAC地址白名单、IoT设备拦截类的防蹭网功能，旧版ESP32 Arduino核心对这类配置兼容性差，可先将2.4G频段加密模式改为WPA2-PSK AES，关闭强制PMF、临时关闭MAC地址过滤后测试。
• 代码侧补充配置清理逻辑：在WiFi.begin()前添加WiFi.disconnect(true, true);，清空芯片内之前存储的WiFi连接配置，避免旧配置干扰连接流程，参考写法：

void setup() {
  Serial.begin(9600);
  WiFi.mode(WIFI_STA);
  // 清空历史WiFi配置，关闭自动重连
  WiFi.disconnect(true, true);
  delay(100);
  WiFi.begin(meuSSID , meuPASS);
  // 原有连接判断逻辑
}

• 升级ESP32 Arduino核心：旧版本ESP32 Arduino核心对新的路由器加密协议、配置兼容性较差，可在开发板管理器中将ESP32核心升级到最新稳定版本后重新烧录测试。

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