Newtonsoft.Json反序列化空值报错？5分钟搞定System.Int32类型转换问题

Newtonsoft.Json反序列化空值处理实战指南

当你在C#项目中处理JSON数据时，是否遇到过这样的报错信息？"Error converting value {null} to type 'System.Int32'"——这几乎是每个C#开发者在使用Newtonsoft.Json进行反序列化时都会碰到的经典问题。特别是在处理来自第三方API或数据库的JSON数据时，空值(null)与值类型(如int)的转换冲突尤为常见。本文将深入剖析这一问题的根源，并提供多种实用解决方案，帮助你在5分钟内彻底解决这个困扰。

1. 问题根源与典型场景

JSON作为一种轻量级的数据交换格式，在Web开发和API交互中无处不在。而C#作为强类型语言，在处理JSON数据时，类型系统的严格性往往会与JSON的灵活性产生冲突。

最常见的场景是：当JSON中包含一个null值，而你的C#模型期望的是一个值类型(如int、double等)时，Newtonsoft.Json会抛出JsonSerializationException。例如：

{
  "userId": 123,
  "age": null,
  "score": 95.5
}

对应的C#类定义：

public class UserProfile 
{
    public int UserId { get; set; }
    public int Age { get; set; }  // 这里会出问题
    public double Score { get; set; }
}

当尝试反序列化时，Age字段会因为null值无法转换为int而抛出异常。这是因为在.NET中：

• 值类型(int, double等)不能为null
• 引用类型(string, object等)可以为null
• JSON中的null在反序列化时需要明确如何处理

2. 基础解决方案：Nullable类型

最直接的解决方案是使用C#的可空值类型(Nullable Value Types)。通过在值类型后添加?，可以明确表示该字段可以接受null值。

修改后的模型类：

public class UserProfile 
{
    public int UserId { get; set; }
    public int? Age { get; set; }  // 使用可空int
    public double Score { get; set; }
}

这样修改后，当JSON中的Age为null时，反序列化会成功，Age属性值将为null而不是抛出异常。使用时可以通过HasValue属性检查是否有值：

if (userProfile.Age.HasValue)
{
    Console.WriteLine($"Age: {userProfile.Age.Value}");
}
else 
{
    Console.WriteLine("Age not specified");
}

优点：

• 简单直接，代码改动小
• 明确表达了字段的可空性
• 与C#类型系统完美集成

缺点<