JSON反序列化失败求助：对象与数组类型不匹配

核心问题定位 #

你遇到的错误本质是实体类属性的类型和JSON对应节点的类型不匹配：实体类里定义为List<T>（数组类型）的属性，在目标JSON里实际是单个对象（{...}），或者反过来。比如你生成的Root.Data是List<Data>，但JSON里的data节点其实是单个对象而非数组。

逐层级核对结构 #

拿着你整理好的JSON结构，从根节点开始逐一对比实体类的属性类型：

• 先看根节点的data：如果JSON里是"data": {...}（单个对象），那实体类Root的Data属性应该是Data类型，而非List<Data>；如果是"data": [...]（数组），才用List<Data>
• 再检查嵌套的entityGraph：同样看JSON里是对象还是数组，对应调整Data类里EntityGraph的类型（是EntityGraph还是List<EntityGraph>）
• 重点看报错信息里明确提到的那个类型，错误提示会直接指出哪个类型无法正确反序列化，顺着这个线索找对应的属性即可。

修正实体类类型 #

找到不匹配的属性后，直接调整类型：
比如JSON里的data是单个对象，修正前后的代码对比：

// 错误定义（数组类型）
public class Root
{
    public List<Data> Data { get; set; }
}

// 正确定义（单个对象类型）
public class Root
{
    public Data Data { get; set; }
}

验证修正结果 #

可以写小段测试代码，先反序列化JSON的局部片段（比如只取data部分）验证类型匹配，确认没问题后再扩展到整个JSON结构，避免一次性处理全量结构的排查难度。

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