ArduinoJson在ESP32文件系统中读写JSON数据的问题分析

问题背景

在使用ArduinoJson库（v7版本）与ESP32开发板配合时，开发者遇到了一个关于JSON数据持久化存储的典型问题。当尝试将JSON格式的数据保存到文件系统中（使用LittleFS或SPIFFS）时，程序运行时能够正确输出预期的值，但在设备重启后读取文件时却返回空输入。

现象描述

开发者提供了两个关键函数：

1. writeFileJson() - 用于将键值对以JSON格式写入文件
2. readFileJson() - 用于从文件中读取指定键的值

运行时观察到的现象是：

• 写入操作后立即读取能够获取正确值
• 设备重启后读取同一文件却得到空输入
• 使用纯文本格式测试时一切正常

代码分析

写入函数分析

写入函数的主要流程：

1. 以写入模式("w")打开文件
2. 创建JsonDocument对象并填充数据
3. 使用serializeJson()序列化到文件
4. 执行fflush()和短暂延迟后关闭文件

潜在问题点：

• 文件打开模式"w"会截断文件，可能不适合某些使用场景
• 延迟时间(10ms)可能不足以确保数据完全写入闪存
• 没有显式检查文件系统是否已正确挂载

读取函数分析

读取函数的主要流程：

1. 以读取模式("r")打开文件
2. 使用FileAdapter适配器进行反序列化
3. 检查JsonDocument是否为空
4. 尝试获取指定键的值

潜在问题点：

• 文件关闭操作(fclose)被放在了条件判断块之后，可能导致某些情况下文件未关闭
• 没有处理文件可能不存在的情况（虽然代码中有检查，但错误处理不够完善）

根本原因

开发者最终发现问题的根源在于文件系统（Flash系统）的初始化或配置问题。ESP32的文件系统（特别是LittleFS/SPIFFS）需要正确初始化和格式化才能可靠地持久化数据。常见原因包括：

1. 文件系统未正确格式化
2. 闪存分区配置不当
3. 写入后没有足够时间让数据完全持久化
4. 文件系统缓存未正确同步

解决方案与最佳实践

针对类似问题，建议采取以下措施：

1. 文件系统初始化检查：

if(!LittleFS.begin(FORMAT_LITTLEFS_IF_FAILED)){
    Serial.println("LittleFS Mount Failed");
    return;
}

2. 确保数据持久化：

• 在写入后调用flush()和close()
• 考虑增加适当的延迟（特别是对于嵌入式系统）

3. 文件操作模式选择：

• 对于需要追加数据的场景，考虑使用"a"模式
• 对于需要确保原子性的操作，考虑写入临时文件后重命名

4. 错误处理增强：

• 检查所有文件操作返回值
• 添加更详细的错误日志

5. JSON处理优化：

• 为JsonDocument分配适当大小
• 检查序列化/反序列化的返回值

经验总结

在嵌入式系统中使用JSON持久化数据时，需要考虑：

1. 文件系统的特性和限制
2. 嵌入式设备上闪存写入的特殊性
3. 数据完整性的保证措施
4. 适当的错误处理和恢复机制

通过系统地检查文件系统配置和遵循最佳实践，可以避免大多数JSON数据持久化相关的问题。