ESP32-S3基于ESP-IDF首次WiFi连接必失败，重试可成功问题排查

针对你遇到的ESP32-S3上电首次连AP必失败、重试后成功的问题，大概率是初始化时序、驱动就绪状态或配置细节的遗漏，以下是具体排查方向和解决方法：

1. 等待WiFi驱动就绪后再发起连接 #

ESP-IDF中，esp_wifi_init()完成后，射频模块并非立即就绪，直接调用esp_wifi_connect()可能失败。需要等待系统发送WIFI_EVENT_WIFI_READY事件后再执行连接操作：

// 在WiFi事件回调中处理就绪事件
static void wifi_event_handler(void* arg, esp_event_base_t event_base,
                               int32_t event_id, void* event_data) {
    if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_WIFI_READY) {
        // 驱动就绪，发起连接
        esp_wifi_connect();
    }
    // 其他事件处理（如连接失败、获取IP等）...
}

不要在esp_wifi_init()后直接调用esp_wifi_connect()，必须等待就绪事件触发。

2. 清除NVS中的旧WiFi配置残留 #

如果设备之前连接过其他AP，NVS中存储的旧配置可能干扰首次连接。在WiFi初始化前清除旧配置：

// 初始化NVS
esp_err_t ret = nvs_flash_init();
if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {
    ESP_ERROR_CHECK(nvs_flash_erase());
    ret = nvs_flash_init();
}
ESP_ERROR_CHECK(ret);

// 清除旧WiFi配置
ESP_ERROR_CHECK(esp_wifi_restore());

// 配置当前AP参数
wifi_config_t wifi_config = {
    .sta = {
        .ssid = "YOUR_SSID",
        .password = "YOUR_PWD",
    },
};
ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &wifi_config));

3. 首次连接前先执行AP扫描 #

上电后射频模块可能未完成信道扫描，直接连接会因找不到AP失败。可以在首次连接前先扫描目标AP，确认存在后再发起连接：

wifi_scan_config_t scan_config = {
    .ssid = "YOUR_SSID", // 只扫描目标AP，节省时间
    .bssid = NULL,
    .channel = 0,
    .show_hidden = true
};
ESP_ERROR_CHECK(esp_wifi_scan_start(&scan_config, true));
// 获取扫描结果，确认AP存在后再调用esp_wifi_connect()

4. 增加上电后电源稳定延时 #

ESP32-S3的射频模块对电源纹波敏感，上电瞬间电源可能不稳定导致射频初始化不完全。可以在app_main()开头加一段短延时：

void app_main() {
    // 上电后延时等待电源稳定
    vTaskDelay(pdMS_TO_TICKS(500));
    
    // 后续WiFi初始化代码...
}

同时检查硬件电源电路，确保LDO输出稳定，纹波小于100mV。

5. 调整WiFi发射功率 #

默认发射功率可能较低，首次上电时信号强度不足导致连接失败。可以手动设置更高的发射功率（注意符合当地射频法规）：

// 设置最大发射功率为20dBm（参数80对应0.25dBm单位，80*0.25=20dBm）
ESP_ERROR_CHECK(esp_wifi_set_max_tx_power(80));

6. 确认系统事件循环正常运行 #

WiFi事件依赖ESP-IDF的系统事件循环，确保你已正确初始化并注册事件回调：

ESP_ERROR_CHECK(esp_event_loop_create_default());
// 注册WiFi和IP事件回调
ESP_ERROR_CHECK(esp_event_handler_register(WIFI_EVENT, ESP_EVENT_ANY_ID, &wifi_event_handler, NULL));
ESP_ERROR_CHECK(esp_event_handler_register(IP_EVENT, IP_EVENT_STA_GOT_IP, &ip_event_handler, NULL));

以上几点覆盖了绝大多数首次连接失败的场景，你可以逐一排查验证。

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