newtonsoft.json 的边界在于类型匹配、空值处理、嵌套访问和性能，需明确配置 jsonserializersettings 并避免默认宽容行为；反序列化失败多因类型与 json 结构不一致，推荐用 jobject/jarray 动态解析或显式指定泛型集合类型。
Newtonsoft.Json 不是“能用就行”的库，它在类型匹配、空值处理、嵌套访问和性能上都有明确的边界——越早看清这些边界，越少在生产环境里被 JsonSerializationException 或静默的 0/null 坑到。
DeserializeObject 为什么经常反序列化失败
直接调用 JsonConvert.DeserializeObject<user>(json)</user> 报错，90% 不是 JSON 写错了，而是 C# 类型和 JSON 结构没对齐：
- JSON 是数组（以
[开头），但目标类型是单个对象User→ 抛JsonSerializationException: Cannot deserialize the current JSON array - C# 属性名是
UserName，JSON 字段是user_name，又没加[JsonProperty("user_name")]→ 该字段始终为默认值（string为null，int为0） - JSON 中
"age": null，而 C# 属性是public int Age { get; set; }→ 不报错，但赋值为0，业务逻辑可能误判 - 日期字段是
"2024-03-15 14:30"这种非 ISO 格式 →DateTime属性反序列化为DateTime.MinValue，且不抛异常
验证方式很简单：先用 JObject.Parse(json) 加载，再逐层检查 obj["data"]?["items"]?[0]?["id"] 是否存在，比硬套类更快定位断点。
JObject 和 JArray 是动态解析的“安全气囊”
当你面对第三方 API 返回结构不稳定、字段带时间戳、或只取其中两三个字段时，硬写模型类反而拖慢迭代。用 JObject 和 JArray 可绕过类型绑定，直接操作 JSON 树：
-
JObject.Parse(json)返回可遍历的对象树，支持链式访问：obj["location"]["city"]?.ToString() - 访问前必须用
?判断是否存在，否则路径中断直接抛NullReferenceException - 要查多层嵌套中的某个字段（比如所有
items下的price），用SelectToken("$..price")比手动循环快得多 -
JArray.Parse(json)后，别用foreach (var item in array)直接遍历 —— 它返回的是JToken，需显式转成item.ToObject<item>()</item>才能当对象用
集合反序列化必须指定具体容器类型
JSON 数组 [{"id":1},{"id":2}] 不能反序列化成 User，也不能用 IEnumerable<user></user> —— 后者没有无参构造函数，会直接失败：
- ✅ 推荐：
JsonConvert.DeserializeObject<list>>(json)</list>，语义清晰，后续可增删 - ✅ 性能敏感场景：
JsonConvert.DeserializeObject<user>(json)</user>，省掉List构造开销 - ❌ 错误：
JsonConvert.DeserializeObject<user>(json)</user>（JSON 是数组） - ❌ 错误：
JsonConvert.DeserializeObject<ienumerable>>(json)</ienumerable>（反序列化器无法实例化接口）
输入可能为空字符串或 null？别依赖库自动兜底：string.IsNullOrWhiteSpace(json) 必须前置校验，否则 DeserializeObject<list>>(null)</list> 返回 null，不是空 List<t></t>。
自定义行为必须靠 JsonSerializerSettings 控制
默认配置下，大小写不敏感、忽略缺失字段、把 null 当默认值——这些“宽容”行为在调试期掩盖问题，在线上引发逻辑错误。关键配置项要主动设：
- 字段名映射：
new JsonSerializerSettings { ContractResolver = new DefaultContractResolver { NamingStrategy = new SnakeCaseNamingStrategy() } }，统一处理user_name→UserName - 空值策略：
NullValueHandling = NullValueHandling.Ignore避免把null写进字段；若需保留，属性本身得声明为string?、int? - 数字容错：
NumberHandling = NumberHandling.AllowLeadingAndTrailingWhitespace | NumberHandling.AllowHexSpecifier，兼容"count": "5"这类字符串数字 - 日期格式：
DateParseHandling = DateParseHandling.DateTimeOffset+DateFormatString = "yyyy-MM-dd HH:mm:ss"，精准匹配非 ISO 时间
真正容易被忽略的，是这些配置**不会自动继承**——每次调用 DeserializeObject 或 SerializeObject 都得显式传入 settings 参数，漏一次就可能让某处逻辑悄悄偏离预期。
