ESP-IDF框架下ESP32无法连接WiFi问题求助

• 核对WiFi配置参数

  • 确认wifi_config_t结构体中SSID、密码与路由器完全一致，注意大小写、特殊字符（如空格、符号），同时检查密码长度是否符合路由器加密规则（WPA2/3通常要求8位以上）。
  • 通过串口打印配置的SSID和密码，排查是否存在字符串截断、赋值错误，避免使用中文SSID（ESP-IDF默认不支持中文SSID，建议更换为英文/数字测试）。

• 检查WiFi初始化流程

  • 确认关键函数调用顺序正确：esp_wifi_init() → esp_wifi_set_mode(WIFI_MODE_STA) → esp_wifi_set_config(ESP_IF_WIFI_STA, &wifi_config) → esp_wifi_start() → esp_wifi_connect()。
  • 验证是否正确注册WIFI_EVENT和IP_EVENT的回调函数，在WIFI_EVENT_STA_DISCONNECTED事件中打印reason错误码，对照ESP-IDF文档的错误码表定位具体原因（比如REASON_AUTH_FAILED表示密码错误，REASON_NO_AP_FOUND表示未搜索到目标AP）。

• 硬件与射频环境排查

  • 确认ESP32天线连接正常（板载天线需确认未被遮挡，外接天线需检查天线座接触是否良好）。
  • 路由器仅开启2.4GHz频段（多数ESP32型号不支持5GHz），并将信道设置为1-13之间的合规信道，避免使用自动信道切换。
  • 尝试将ESP32靠近路由器测试，排除周围强射频干扰（如微波炉、蓝牙设备）的影响。

• 代码逻辑与资源冲突排查

  • 注释掉aht25传感器驱动代码，单独测试WiFi连接，排查传感器I2C通信是否阻塞WiFi任务或占用过多系统资源。
  • 检查FreeRTOS任务优先级，确保WiFi相关任务优先级足够，避免被低优先级任务长时间抢占导致连接超时。
  • 确认esp_wifi_connect()调用后有足够的等待时间，或添加自动重连逻辑（比如在断开事件触发后延迟重新调用esp_wifi_connect()）。

• 日志调试

  • 在menuconfig中开启Debug级日志：Component config -> Log output -> Default log verbosity设为Debug，查看串口输出的WiFi连接全流程日志，重点关注扫描AP、发起连接、认证阶段的详细信息。
  • 打印esp_wifi_connect()的返回值，若返回非ESP_OK，根据返回码（如ESP_ERR_WIFI_CONN）直接定位问题。

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