C#使用Json.NET反序列化异构JSON字段时报错或返回null的问题
Json.NET反序列化该结构的常见问题与解决方法
失败的核心原因
你遇到的解析报错、返回null的问题,基本都是踩了这两类坑:
- 对
field_value字段做了单一类型硬绑定:该字段在JSON里是多类型结构,一会存普通字符串、一会存数值字符串、一会存字符串数组,硬绑定成string、int这类单类型时,遇到数组结构的field_value节点会直接抛类型不匹配错误 - 根节点结构匹配错误:你提供的JSON根节点是纯数组,不是带嵌套键的对象,如果反序列化时硬套了带外层属性的类结构,读取结果自然会是null
具体解决方法
方案1:强类型实体兼容多类型字段
定义和JSON结构完全匹配的实体类,用JToken作为field_value的类型,兼容所有可能的字段值结构:
using Newtonsoft.Json; using Newtonsoft.Json.Linq; using System.Collections.Generic; public class OrderFormField { [JsonProperty("field_name")] public string FieldName { get; set; } /// <summary> /// 用JToken兼容所有field_value的类型,不管是字符串、数字、数组都能正常读取 /// </summary> [JsonProperty("field_value")] public JToken FieldValue { get; set; } }
反序列化核心代码:
// 从数据库字段取出的原始JSON字符串 string rawDbJson = "你从库表读出的完整JSON内容"; // 直接匹配根节点数组结构,反序列化不会抛出类型错误 var formFieldList = JsonConvert.DeserializeObject<List<OrderFormField>>(rawDbJson);
读取具体字段值时按需转换即可:
- 读取普通字符串值(比如
nome、cognome):var userName = formFieldList.First(x => x.FieldName == "nome").FieldValue.ToString(); // 拿到值"Pinco" - 读取数组结构值(比如
servizio):var serviceList = formFieldList.First(x => x.FieldName == "servizio").FieldValue.ToObject<List<string>>(); // 拿到值["Video "] - 读取数值类值(比如
totale_ordine):var orderTotal = decimal.Parse(formFieldList.First(x => x.FieldName == "totale_ordine").FieldValue.ToString()); // 拿到值29.99
方案2:无实体动态解析(适合临时调试场景)
如果不想提前定义实体类,直接用JArray解析原始JSON即可,不会触发类型匹配错误:
string rawDbJson = "你从库表读出的完整JSON内容"; var jsonArray = JArray.Parse(rawDbJson); // 举例:读取cognome字段的值 var lastName = jsonArray.Children() .First(item => (string)item["field_name"] == "cognome")?["field_value"]?.ToString();
高频踩坑提醒
- 给
field_value硬绑定string类型是最常见的报错来源:遇到"field_value": ["Video "]的数组结构时,会直接抛出Unexpected character encountered while parsing value: [的路径指向[2].field_value位置的解析错误 - 不要额外添加外层包装类:当前JSON根节点没有嵌套包裹,直接按数组结构解析即可,强行套带属性的外层类会导致反序列化结果为null
- 注意JSON内的字符串附带的前后空格:比如
servizio的字段值是带尾部空格的"Video ",可以按需在读取时做Trim处理,不影响基础反序列化流程
内容的提问来源于stack exchange,提问作者Marco Meditek
相关产品推荐
相关产品推荐

