.NET POST API：为何FromBody填充非可空类型默认值，反序列化Null却报错？

这个问题其实涉及到ASP.NET Web API模型绑定和Newtonsoft.Json库两种完全不同的设计理念，我来给你拆解清楚：

1. [FromBody]模型绑定的行为逻辑 #

ASP.NET Web API的[FromBody]参数绑定系统，本质是为了优雅处理HTTP请求的不确定性——毕竟客户端传过来的请求数据可能不完整、字段缺失甚至格式有小问题。

对于非可空值类型（比如你的int Age），它的设计逻辑是：

• 如果请求中没有提供Age字段，或者字段值为null，绑定系统会自动填充该值类型的默认值（比如int的默认值是0）
• 同时，它会把绑定过程中的异常（比如类型不匹配、必填字段缺失）记录到ModelState里，而不是直接抛出异常中断请求。你可以通过检查ModelState.IsValid来判断数据是否合法，再做后续处理

这种设计的目的是让你的控制器方法能正常执行，把数据校验的控制权交还给开发者，而不是因为一点小问题就直接返回500错误。

2. JsonConvert.DeserializeObject的严格约束 #

Newtonsoft.Json（也就是你用的JsonConvert所属的库）是一个通用的JSON序列化/反序列化工具，它的默认设计更偏向于严格遵循CLR的类型规则。

在CLR中，非可空值类型（比如int）是不能被赋值为null的，所以当你尝试把JSON中的null值反序列化为非可空值类型时：

• 库会认为这是一个无效的类型转换，直接抛出JsonSerializationException
• 它不会自动填充默认值，因为默认行为是严格保证类型的正确性，避免开发者因为意外的类型转换产生bug

当然，如果你想让它和[FromBody]的行为一致，也可以通过配置调整：

var settings = new JsonSerializerSettings
{
    // 忽略JSON中的null值，不尝试反序列化到对应字段
    NullValueHandling = NullValueHandling.Ignore,
    // 为缺失的字段填充默认值
    DefaultValueHandling = DefaultValueHandling.Populate
};
item = JsonConvert.DeserializeObject<Item>(reqContent, settings);

这样配置后，当JSON中Age字段为null或者缺失时，就会自动填充0，和[FromBody]的行为一致了。

核心差异总结 #

• [FromBody]是Web API专为HTTP请求设计的绑定系统，优先保证请求能到达控制器，通过ModelState和默认值处理数据不完整的情况
• JsonConvert是通用JSON处理库，默认严格遵循CLR类型约束，遇到不匹配的null值会抛出异常，可通过配置调整行为

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