ESP32 UART任务栈溢出问题求助（ESP-IDF+VS Code环境）

环境 #

• 硬件：Lolin开发板（ESP-WROOM-32模块）
• 开发环境：VS Code + ESP-IDF
• 错误信息：

***ERROR*** A stack overflow in task uart_task has been detected

代码场景 #

创建了周期1秒的uart_task，每秒从UART2读取256字节数据到缓冲区，检查开头模式后调用parse()函数解析，错误出现在vTaskDelay执行时。

相关代码 #

UART任务代码

char uart_recv_data[256] = "";
static void uart_task(void *arg)
{
    uart_config_t uart_config = {
        .baud_rate = 115200,
        .data_bits = UART_DATA_8_BITS,
        .parity    = UART_PARITY_DISABLE,
        .stop_bits = UART_STOP_BITS_1,
        .flow_ctrl = UART_HW_FLOWCTRL_DISABLE,
        .source_clk = UART_SCLK_APB,
    };

    uart_driver_install(2, 256 * 2, 0, 0, NULL, 0);
    uart_param_config(2, &uart_config);
    uart_set_pin(2, 17, 16, -1, -1);

    while (1) {
        uart_read_bytes(2, uart_recv_data, 256, TIMEOUT);
        ESP_LOGI(UART_TAG, "%s", uart_recv_data);

        if(!strncmp(uart_recv_data, "pattern", 7)){
            parse();
        }
        uart_recv_data[0] = '\0';
        vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
}

解析函数代码

void parse(){
    bool ret;
    MyClass myClass = MyClass();
    myClass.parse_string(uart_recv_data);
}

MyClass::parse_string(char* buffer)仅通过sscanf()提取整数。

原因分析 #

1. 任务栈空间不足：ESP-IDF中创建FreeRTOS任务时，默认栈大小（如configMINIMAL_STACK_SIZE）通常仅适合简单任务。而你的任务中调用了ESP_LOGI、sscanf这类栈占用较大的函数，同时在parse()里栈上创建MyClass实例，进一步消耗栈空间。栈溢出的触发点在vTaskDelay，是因为该函数会触发FreeRTOS的栈检查机制，此时才检测到栈已经溢出。
2. sscanf的栈占用：标准库的sscanf函数在处理字符串时需要分配临时栈空间，尤其是当解析格式较复杂时，栈消耗会超出预期。

解决方案 #

1. 增大uart_task的栈空间 #

在创建uart_task的代码中，将栈大小参数从默认值（通常是configMINIMAL_STACK_SIZE，对应2048字节）调整为更大的值，比如4096或8192字节：

xTaskCreate(uart_task, "uart_task", 4096, NULL, 5, NULL);

注意：栈大小单位是字节，根据实际情况调整，避免过度占用RAM。

2. 优化parse()函数的栈使用 #

将MyClass实例改为全局变量或静态变量，避免每次调用parse()时在栈上创建实例，减少栈空间的重复分配：

// 全局或静态实例
static MyClass myClass;

void parse(){
    bool ret;
    myClass.parse_string(uart_recv_data);
}

3. 替换sscanf为更轻量的解析方式 #

如果栈空间仍然紧张，可以考虑用手动字符串解析替代sscanf，比如通过strtok配合atoi/strtol，减少标准库函数的栈占用：

// 示例：手动解析整数
void parse_string(char* buffer) {
    char* token = strtok(buffer, ","); // 根据实际分隔符调整
    while(token != NULL) {
        int num = atoi(token);
        // 处理解析出的整数
        token = strtok(NULL, ",");
    }
}

4. 启用栈溢出检测与分析 #

在ESP-IDF配置中开启栈溢出检测（CONFIG_FREERTOS_CHECK_STACKOVERFLOW），并使用uxTaskGetStackHighWaterMark函数查看任务栈的剩余空间，精准调整栈大小：

static void uart_task(void *arg)
{
    // ... 初始化代码 ...
    // 打印栈剩余空间（单位：字，每个字4字节）
    ESP_LOGI(UART_TAG, "Stack high water mark: %u", uxTaskGetStackHighWaterMark(NULL));
    
    while (1) {
        // ... 循环代码 ...
    }
}

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