ESP32 Arduino SPIFFS读文件时字符数组操作崩溃及缓冲区优化问题

• 最核心的错误是未分配内存的野指针操作：char* return_message; 仅声明了一个指针变量，没有给它分配任何堆或栈内存空间，本质是个指向随机内存地址的野指针。后续执行strcat(return_message, &c)时，相当于直接往随机内存地址写数据，这就是打印乱码、ESP32触发Stack smashing protect failure崩溃的直接原因——ESP32默认开启栈保护，检测到栈内存被越界改写后会直接重启设备。
• strcat的用法本身完全错误：这个函数要求两个入参都是以\0结尾的合法C字符串，传入的&c只是单个字符的内存地址，后面根本没有字符串终止符，strcat会沿着这个地址一直往后读内存，直到碰到随机出现的\0为止，输出自然是毫无规律的乱码。
• 早期尝试传参的写法存在空指针访问问题：char* saved_networks = NULL; readFile(SPIFFS, "/wifi.txt", &saved_networks[0]); 本质是对空指针做解引用取地址，函数拿到这个无效地址往里面写数据时，会直接触发内存访问异常，没有任何正常工作的可能。

• 固定长度数组的固有缺陷：一方面如果待读取文件的实际长度超过你声明的数组长度，会直接越界改写相邻内存，再次触发栈保护崩溃；另一方面不管文件实际大小，哪怕文件只有20字节，声明的100/10000字节数组也会一直占用栈空间，ESP32的任务栈本身空间有限，开超大数组很容易把栈挤爆。
• 读取逻辑缺少字符串终止符：逐字符把文件内容写进数组后，没有在最后一个字符后面手动补\0，当你用Serial.println()打印数组内容时，函数会一直读到内存里随机出现的\0，还是会出现部分随机乱码。

方案1：按需动态分配精确大小的缓冲区 #

这是解决“无法预知文件大小、不想浪费内存”需求的最合理方案，SPIFFS的文件对象自带实际大小查询能力，完全不需要猜文件长度：

char* readFile(fs::FS &fs, const char *path)
{
    File file = fs.open(path);
    if (!file || file.isDirectory())
    {
        Serial.println("Failed to open file for reading");
        return NULL;
    }
    // 直接获取文件实际占用的字节长度
    size_t file_len = file.size();
    // 申请 file_len + 1 字节的内存，多出来的1字节专门存字符串终止符\0
    char* buffer = (char*)malloc(file_len + 1);
    if (!buffer)
    {
        Serial.println("Memory allocation failed");
        file.close();
        return NULL;
    }
    // 一次性读取整个文件到缓冲区，比逐字符读取效率高几个数量级
    file.read((uint8_t*)buffer, file_len);
    // 手动补字符串终止符，生成合法的C字符串
    buffer[file_len] = '\0';
    file.close();
    return buffer;
}

调用逻辑非常简单，用完及时释放即可：

char* saved_networks = readFile(SPIFFS, "/wifi.txt");
if (saved_networks)
{
    Serial.println(saved_networks);
    // 用完立刻释放内存，避免内存泄漏
    free(saved_networks);
    saved_networks = NULL;
}

这种方式内存利用率达到100%：文件多大就申请多大的空间，没有任何冗余，也完全不需要提前猜测文件长度，ESP32有数百KB的可用堆内存，存储WiFi名称、配置项这类几KB的文件完全没有压力。

方案2：无动态内存的安全写法 #

如果不想使用malloc/free，也完全不需要开10000字节的巨型数组：

• 结合业务场景设置合理的缓冲区上限，比如WiFi名称最长也就32字节，全局配置最多1-2KB，根本不需要开超大数组；
• 读取时增加长度校验，超过缓冲区容量就自动截断，从机制上避免越界：

void readFile(fs::FS &fs, const char *path, char* out_buf, size_t buf_max_len)
{
    File file = fs.open(path);
    if (!file || file.isDirectory())
    {
        out_buf[0] = '\0';
        return;
    }
    // 取文件长度和缓冲区最大可用长度的较小值，预留1个位置存\0
    size_t read_len = min(file.size(), buf_max_len - 1);
    file.read((uint8_t*)out_buf, read_len);
    out_buf[read_len] = '\0';
    file.close();
}

调用时把实际申请的缓冲区大小作为参数传入，自动做截断保护：

// 按业务需要设置合理大小，存WiFi名开64字节就完全足够
char saved_networks[64];
readFile(SPIFFS, "/wifi.txt", saved_networks, sizeof(saved_networks));
Serial.println(saved_networks);

• 所有C风格字符串操作，必须保证最后有\0终止符，否则所有依赖字符串长度的函数（Serial打印、字符串拼接、字符串比较）都会因为读越界出现乱码或崩溃。
• 逐字符拼接字符串时，直接通过数组索引写入内容（比如buf[pos++] = c），最后统一补\0即可，不需要反复调用strcat，既容易出语法错误，效率也很低。
• 栈上分配的数组不要设置过大，ESP32单个任务的默认栈空间通常只有几KB，需要大缓冲区就用堆内存的malloc申请，避免栈溢出。

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