使用Nlohmann JSON反序列化时遇类型错误：需数组却为对象

核心问题 #

你遇到的错误本质是JSON结构与C++结构体的映射不匹配：代码期望反序列化一个数组类型，但实际读取的JSON是对象类型（键值对形式）。

问题排查与验证 #

对照你的JSON样本和C++结构体就能明确问题：

触发错误的典型JSON结构 #

{
  "scenes": {
    "main_menu": {
      "elements": [/* UI元素配置 */]
    },
    "game_scene": {
      "elements": [/* UI元素配置 */]
    }
  }
}

这里的scenes是对象（用{}包裹，以场景名称为键、场景数据为值）。

对应的C++结构体定义（错误匹配） #

struct StructScene {
    std::vector<UIElement> elements;
    // 其他场景字段
};

struct StructScenes {
    std::vector<StructScene> scenes; // 代码期望JSON是数组类型
};

Nlohmann JSON的默认序列化规则是：数组（[]）对应序列容器（如std::vector），对象（{}）对应键值容器（如std::map或带键的结构体）。当你调用get<StructScenes>()时，库会尝试把JSON里的scenes对象转成std::vector，自然触发类型不匹配错误。

两种解决方法 #

方法1：修改JSON结构适配C++代码 #

把scenes改成数组形式，给每个场景对象增加name字段：

{
  "scenes": [
    {
      "name": "main_menu",
      "elements": [/* UI元素配置 */]
    },
    {
      "name": "game_scene",
      "elements": [/* UI元素配置 */]
    }
  ]
}

这样std::vector<StructScene>就能正确匹配JSON数组，反序列化不会报错。

方法2：修改C++结构体适配JSON结构 #

如果不想改动JSON，把StructScenes里的vector改成std::map，用场景名称作为键：

struct StructScenes {
    std::map<std::string, StructScene> scenes; // 匹配JSON的对象结构
};

之后直接执行反序列化即可：

StructScenes scenesData = uiConfig.get<StructScenes>();

额外说明 #

你尝试直接反序列化为std::vector<StructScene>时同样报错，原因和上述一致——JSON里的scenes是对象，无法转换为数组类型的vector。

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