Newtonsoft.Json 反序列化时处理$type属性位置问题的解决方案
问题背景
在使用Newtonsoft.Json进行JSON序列化和反序列化时,当设置了TypeNameHandling = TypeNameHandling.All
选项,系统会在JSON数据中添加类型信息$type
属性。然而在某些情况下,特别是当JSON数据经过浏览器处理后,$type
属性的位置可能会发生变化,导致反序列化失败。
典型场景
考虑以下C#类定义:
public class Test1
{
public Dictionary<string, decimal> Data { get; set; }
}
当这个对象被序列化为JSON并经过浏览器处理后,可能会产生如下格式的JSON:
{
"$type": "Test.Core.Test1, Test.Core",
"Data": {
"0": 1,
"1": 2,
"2": 3,
"$type": "System.Collections.Generic.Dictionary`2[[...]]"
}
}
注意Data
对象中的$type
属性被浏览器移动到了最后位置。
问题现象
当尝试反序列化这样的JSON时,Newtonsoft.Json会抛出异常:"Could not convert string to decimal: System.Collections.Generic.Dictionary`2[...]",错误指向路径'Data.$type'。
原因分析
Newtonsoft.Json默认情况下出于性能和内存考虑,只在JSON对象的开始处查找元数据关键字(如$type
)。当这些关键字出现在对象中间或末尾时,解析器会尝试将其作为普通属性处理,从而导致类型转换错误。
解决方案
要解决这个问题,需要显式配置JsonSerializerSettings,使其在反序列化时提前读取JSON数据以查找元数据关键字。这可以通过设置MetadataPropertyHandling
属性为ReadAhead
来实现:
var settings = new JsonSerializerSettings
{
TypeNameHandling = TypeNameHandling.All,
MetadataPropertyHandling = MetadataPropertyHandling.ReadAhead
};
var demoData = JsonConvert.DeserializeObject<Test1>(jsonString, settings);
性能考量
MetadataPropertyHandling.ReadAhead
选项会使Newtonsoft.Json在解析过程中缓冲JSON数据,以便能够检测到位于任何位置的元数据属性。这会带来一定的性能开销和内存使用增加,但对于需要处理浏览器修改过的JSON数据或不确定$type
属性位置的场景,这是必要的代价。
最佳实践建议
- 在客户端-服务器交互中,如果确定JSON数据不会被中间件修改,可以保持默认设置以获得最佳性能
- 当JSON数据可能经过浏览器或其他可能重新排序属性的处理器时,应使用
ReadAhead
选项 - 考虑在全局JsonConvert.DefaultSettings中统一配置这些设置,确保应用行为一致
- 对于性能敏感的场景,可以尝试其他序列化方案或确保数据源保持
$type
属性在对象开头
总结
Newtonsoft.Json提供了灵活的序列化配置选项,MetadataPropertyHandling.ReadAhead
是处理元数据属性位置变化问题的有效解决方案。开发者应根据具体应用场景和性能需求,合理配置这些选项,确保数据反序列化的可靠性和稳定性。
HunyuanImage-3.0
HunyuanImage-3.0 统一多模态理解与生成,基于自回归框架,实现文本生成图像,性能媲美或超越领先闭源模型00ops-transformer
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。C++043Hunyuan3D-Part
腾讯混元3D-Part00GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0288Hunyuan3D-Omni
腾讯混元3D-Omni:3D版ControlNet突破多模态控制,实现高精度3D资产生成00GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile09
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
项目优选









