ESP32 Wi-Fi Manager组件xQueueSemaphoreTake断言失败求助

问题背景 #

基于ESP32开发Wi-Fi Manager组件时，触发xQueueSemaphoreTake断言失败错误，耗时三天未解决。开发环境为esp-idf v4.4，使用ESP32模块。

核心代码片段 #

main函数流程 #

void app_main(void)
{
    esp_err_t ret = ESP_FAIL;

    /* Initialize NVS partition */
    ret = nvs_flash_init();
    if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND)
    {
        /* NVS partition was truncated and needs to be erased */
        ESP_ERROR_CHECK(nvs_flash_erase());

        /* Retry nvs_flash_init */
        ESP_ERROR_CHECK(nvs_flash_init());
    }

    ret = wifim_wifi_on();
    if (ret != ESP_OK)
    {
        return;
    }

    wifi_config_t wifi_config;
    memset(&wifi_config, 0, sizeof(wifi_config_t));

    // Copy the SSID and password to the wifi_config structure
    strncpy((char *)wifi_config.sta.ssid, WIFI_SSID, sizeof(wifi_config.sta.ssid) - 1);
    wifi_config.sta.ssid[sizeof(wifi_config.sta.ssid) - 1] = '\0'; // Ensure null-terminated string

    strncpy((char *)wifi_config.sta.password, WIFI_PASSKEY, sizeof(wifi_config.sta.password) - 1);
    wifi_config.sta.password[sizeof(wifi_config.sta.password) - 1] = '\0'; // Ensure null-terminated string
    wifi_config.sta.channel = 0;
    wifi_config.sta.threshold.authmode = WIFI_AUTH_WPA_WPA2_PSK;
    ret = wifim_connect_ap(&wifi_config);
    if (ret == ESP_OK)
    {
        // Connection successful
        ESP_LOGI(TAG, "Connection successful");
    }
    else
    {
        // Connection failed, handle the error
        ESP_LOGI(TAG, "Connection failed %s", esp_err_to_name(ret));
    }

    return;
}

Wi-Fi Manager核心逻辑位于core_wifim.c中。

错误日志 #

I (0) cpu_start: App cpu up.
I (371) cpu_start: Pro cpu start user code
I (371) cpu_start: cpu freq: 160000000
...
assert failed: xQueueSemaphoreTake queue.c:1545 (( pxQueue ))
Setting breakpoint at 0x400819e9 and returning...
0x400819e9: panic_abort at /home/raghav/workspace/esp/esp-idf/components/esp_system/panic.c:402

排查思路 #

• 信号量初始化检查：确认xQueueSemaphoreCreate/xSemaphoreCreateBinary等初始化操作在xQueueSemaphoreTake之前执行，且返回的句柄不为NULL。未初始化的空句柄会直接触发该断言。
• 信号量生命周期验证：排查是否存在信号量被提前调用vQueueDelete删除后，仍有任务执行xQueueSemaphoreTake的情况，比如Wi-Fi事件回调中错误释放了信号量资源。
• 多线程访问安全：检查全局信号量句柄是否被多任务非法修改，比如未加互斥保护导致句柄被覆盖为无效值。
• esp-idf API顺序合规性：esp-idf v4.4的Wi-Fi栈对初始化顺序有严格要求，确认wifim_wifi_on中已完成Wi-Fi驱动初始化、事件循环/信号量创建后，再调用wifim_connect_ap。
• core_wifim.c细节排查：重点查看wifim_connect_ap及关联函数中xQueueSemaphoreTake的调用点，核对传入的句柄是否有效，是否存在未初始化就使用的情况。

解决方案方向 #

• 强制初始化校验：在创建信号量后立即检查返回值，避免使用无效句柄：

  SemaphoreHandle_t connect_sem = xSemaphoreCreateBinary();
  if (connect_sem == NULL) {
      ESP_LOGE(TAG, "Failed to create connection semaphore");
      return ESP_FAIL;
  }
  

• 规范信号量删除时机：确保vQueueDelete仅在所有等待该信号量的任务退出后调用，禁止在任务未结束时提前释放信号量资源。
• 修正事件回调逻辑：检查Wi-Fi事件处理函数中xSemaphoreGive的调用，确保仅在信号量有效时执行释放操作，避免重复释放或释放空句柄。
• 对齐官方初始化流程：参考esp-idf v4.4官方Wi-Fi连接示例，调整wifim_wifi_on和wifim_connect_ap的执行顺序，确保Wi-Fi驱动、事件循环、信号量等资源初始化完成后再发起连接。

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