ArduinoJson库中JsonArray.size()返回0问题的解决方案

在使用ArduinoJson库处理JSON数据时，开发者可能会遇到一个常见问题：成功反序列化JSON数组后，调用JsonArray.size()却始终返回0。本文将深入分析该问题的成因，并提供完整的解决方案。

问题现象

当开发者尝试读取SPIFFS中的JSON数组文件并进行反序列化时，虽然能够成功遍历数组元素，但通过to<JsonArray>()转换后调用size()方法却返回0值。示例JSON文件包含多个电台信息对象，结构如下：

[
  {
    "name": "Cork 96fm",
    "url": "https://wg.cdn.tibus.net/96fm"
  },
  // 更多电台...
]

问题根源

经过分析，发现问题出在错误的类型转换方法上。开发者使用了to<JsonArray>()而非正确的as<JsonArray>()方法：

• to<T>()：执行类型转换并返回新对象
• as<T>()：返回原始数据的视图引用

在ArduinoJson中，to<T>()会创建一个新的空数组，而as<T>()才能正确获取原始数组引用。

正确解决方案

正确的做法是使用as<JsonArray>()获取数组引用：

JsonArray arr = doc.as<JsonArray>();
int count = arr.size();  // 现在能获取正确元素数量

内存管理最佳实践

对于需要长期保存反序列化数据的情况，开发者需要注意：

1. 避免直接引用JSON文档中的字符串：这些字符串的生命周期与JsonDocument绑定
2. 推荐使用固定大小字符数组：防止内存泄漏
3. 动态内存分配方案：如需动态分配，应使用strndup复制字符串

示例结构体定义和内存分配：

typedef struct {
  char name[64];  // 固定大小缓冲区
  char url[128];
} StationInfo;

StationInfo* stations = new StationInfo[count];

完整实现示例

以下是经过优化的完整代码实现：

bool loadStations(const char* filename, StationInfo* &output, int& count) {
  File file = SPIFFS.open(filename);
  if(!file) return false;
  
  JsonDocument doc;
  if(deserializeJson(doc, file)) return false;

  JsonArray arr = doc.as<JsonArray>();
  count = arr.size();
  
  output = new StationInfo[count];
  for(int i=0; i<count; i++) {
    strncpy(output[i].name, arr[i]["name"], sizeof(StationInfo::name)-1);
    strncpy(output[i].url, arr[i]["url"], sizeof(StationInfo::url)-1);
  }
  
  file.close();
  return true;
}

总结

处理ArduinoJson时，理解视图(as<>)和转换(to<>)的区别至关重要。对于配置数据的长期存储，建议采用固定大小缓冲区或妥善管理的动态内存方案。遵循这些原则可以构建出既高效又稳定的嵌入式JSON处理程序。

通过本文的解决方案，开发者可以避免常见的陷阱，确保JSON数组操作的正确性，同时保证系统的内存安全。