单片机可以使用cJSON吗

🌟 关注「嵌入式软件客栈」公众号 🌟，解锁实战技巧！💻🚀

cJSON 作为轻量级 C 语言 JSON 解析库，因其 API 简洁、移植性强，在嵌入式开发领域被广泛采用。然而，许多开发者在小内存单片机上使用 cJSON 时，常常遭遇内存占用高、内存泄漏等隐蔽问题，严重影响系统稳定性

内存管理原理

cJSON 采用动态内存分配（malloc/free）管理 JSON 节点，每个 cJSON 结构体节点都可能单独分配内存。其树状结构意味着每个对象、数组、字符串、数字等都对应独立的内存块。cJSON_Delete 负责递归释放整个树，但其行为有一些容易被忽视的细节。

内存挑战

• 单片机 RAM 极为有限（常见 2KB~128KB），大对象/深层嵌套 JSON 极易耗尽内存。
• 动态分配碎片化严重，频繁分配/释放导致堆空间零散，降低可用内存。
• 内存泄漏难以察觉，长时间运行后系统崩溃或异常。

单片机使用 cJSON 的不友好

1. 内存占用不可控

cJSON 每创建一个节点（对象、数组、字符串、数字等）都会动态分配内存，且每个节点的结构体本身就有一定大小（通常 20~40 字节），加上字符串内容的深拷贝，实际占用远超 JSON 文本本身。对于 RAM 仅几 KB 的 MCU，稍大一点的 JSON 就可能导致内存耗尽。

2. 堆碎片化加剧

cJSON 频繁调用 malloc/free，尤其在解析/构建复杂 JSON 时，极易造成堆空间碎片化。嵌入式堆管理能力有限，碎片化后即使有足够总内存，也可能因无法分配连续空间而失败。

3. 内存泄漏风险高

cJSON 的树状结构和递归释放机制，稍有不慎（如未正确释放临时节点、误用 API），就会遗留内存，长时间运行后 MCU 可能死机或重启。

4. 性能与实时性影响

动态分配和递归释放操作在 MCU 上耗时较长，影响实时性任务，甚至引发系统卡顿。

5. 调试和定位困难

嵌入式环境缺乏完善的内存检测工具，内存泄漏和碎片化问题难以及时发现和定位。

典型场景示例

• 解析来自云端/外设的较大 JSON 配置，MCU 直接崩溃或重启。
• 长时间运行后，系统可用内存逐步减少，最终死机。
• 频繁收发 JSON 消息，堆空间碎片化，偶发性分配失败。

对比方案

• cJSON：API 友好，功能全，但动态分配多，内存占用高。
• tiny-json：更适合 MCU，支持静态分配、零拷贝，功能精简。
• 手写解析/拼接：最省内存，但开发和维护成本高。

优化建议

1. 优先使用静态分配 JSON 库，如 tiny-json。
2. 如必须用 cJSON，建议：
   • 预估最大 JSON 结构，限制嵌套层级和节点数。
   • 复用节点，减少频繁分配/释放。
   • 自定义内存分配器，采用静态内存池，避免系统堆碎片化。
   • 解析后尽快释放无用节点，避免长时间持有。
   • 定期重启或主动回收，防止内存泄漏累积。
3. 简化 JSON 协议，减少字段和嵌套，降低解析压力。

常见内存高占用与泄漏

cJSON_Delete导致的链式释放

cJSON_Delete 的实现会递归释放传入节点及其所有兄弟节点（即链表后续节点），如果直接对数组/对象成员调用，可能导致整个链表被释放，造成野指针或重复释放。

错误示例：

cJSON *item = cJSON_GetArrayItem(array, 1);
cJSON_Delete(item); // 错误！会释放 item 及其后续兄弟节点

正确做法：

• 先用 cJSON_DetachItemFromArray/FromObject 脱链，再单独释放。

cJSON *item = cJSON_DetachItemFromArray(array, 1);
cJSON_Delete(item); // 正确

cJSON 对字符串的深拷贝陷阱

cJSON 默认会对字符串进行深拷贝（即分配新内存并复制内容），如果频繁添加字符串或未及时释放，极易造成内存飙升。

示例：

cJSON *root = cJSON_CreateObject();
for (int i = 0; i < 100; ++i) {
    char buf[32];
    sprintf(buf, "val_%d", i);
    cJSON_AddStringToObject(root, "key", buf); // 每次都分配新内存
}
cJSON_Delete(root); // 需整体释放

未及时释放中间节点

解析/构建复杂 JSON 时，临时节点未及时释放，导致内存残留。

示例：

cJSON *arr = cJSON_CreateArray();
for (int i = 0; i < 10; ++i) {
    cJSON *obj = cJSON_CreateObject();
    cJSON_AddNumberToObject(obj, "id", i);
    cJSON_AddItemToArray(arr, obj); // obj 被 arr 管理，无需手动释放
}
// ...
cJSON_Delete(arr); // 一次性释放所有节点

注意： 若未加入数组/对象，需手动释放。

动态分配数组/对象的递归释放风险

cJSON_Delete 会递归释放所有子节点，若节点被多处引用或未脱链，易引发重复释放或内存泄漏。

关注 嵌入式软件客栈 公众号，获取更多内容