ArduinoJson库中JsonObject与JsonDocument的正确使用

在使用ArduinoJson库进行JSON数据解析时，开发者经常会遇到内存分配错误的问题。本文将深入分析一个典型的错误案例，并讲解如何正确使用JsonObject和JsonDocument。

问题现象

在使用ESP32 Wrover-E（8MB外部RAM）配合ArduinoJson v7时，开发者遇到了"NoMemory"错误，尽管系统显示有充足的可用内存（内部堆112KB，外部RAM 4MB）。错误发生在尝试解析一个仅117字节的JSON字符串时。

错误原因分析

核心问题在于代码中直接使用了未初始化的JsonObject来接收反序列化结果：

JsonObject doc;
DeserializationError err = deserializeJson(doc, frame);

这种用法是错误的，因为：

1. JsonObject本身不包含内存分配能力
2. 反序列化需要一个容器来存储解析后的数据结构

正确解决方案

应该使用JsonDocument作为容器来接收反序列化结果：

JsonDocument doc;
DeserializationError err = deserializeJson(doc, frame);

技术原理

1. JsonDocument：是ArduinoJson中的核心容器类，负责内存管理和数据结构存储
2. JsonObject：只是对JsonDocument中数据的引用，本身不拥有内存
3. 内存分配：反序列化时，JsonDocument会根据JSON内容自动分配所需内存

最佳实践建议

1. 总是先创建JsonDocument实例
2. 使用反序列化后的JsonDocument获取JsonObject引用
3. 对于大JSON数据，考虑预分配容量以避免碎片化

// 正确用法示例
JsonDocument doc;
DeserializationError err = deserializeJson(doc, jsonString);
if(!err) {
    JsonObject obj = doc.as<JsonObject>();
    // 使用obj处理数据
}

总结

理解JsonDocument和JsonObject的区别是使用ArduinoJson库的关键。JsonDocument作为容器负责内存管理，而JsonObject只是数据的视图。正确使用这两者可以避免内存分配错误，确保JSON解析的稳定性。