ASP.NET Core MVC模型绑定错误位置查询及类型不匹配致参数为空疑问

我来帮你搞定这两个ASP.NET Core MVC里的模型绑定问题，都是日常开发中容易踩的坑：

在ASP.NET Core MVC里，模型绑定的错误信息主要集中在这几个地方：

• ModelState集合：这是最直接的入口，控制器里的ModelState.IsValid属性会告诉你是否存在绑定错误。如果要查看具体错误，可以遍历ModelState.Values.SelectMany(v => v.Errors)，每个错误条目里包含了错误消息和对应的异常（如果有的话）。比如要定位某个属性的错误，直接访问ModelState["Age"]?.Errors就能看到这个属性的绑定问题。
• 自动API响应（Web API场景）：如果你的控制器加了[ApiController]特性，框架会自动把ModelState里的错误包装成400 Bad Request响应返回给客户端，不用你手动处理，响应体里会列出所有错误详情。
• 应用日志：如果把应用日志级别调到Debug或Trace，ASP.NET Core会把模型绑定的全过程（包括每个属性的绑定结果、错误原因）输出到日志里，适合排查一些隐蔽的绑定问题。

你说的这个现象确实存在——当使用[FromBody]绑定JSON时，如果某个属性的类型无法转换（比如int类型的Age传了字符串"asdf"），默认情况下整个模型会变成null，这是因为默认的JSON序列化器（System.Text.Json）在反序列化遇到无法处理的错误时，不会做部分绑定，直接返回null。

这里有几个实用的解决方案：

• 把模型属性改成可空类型：这是最简单的处理方式，比如把int Age改成int? Age，DateTime RegistrationDate改成DateTime? RegistrationDate。这样即使某个属性无法转换，只会让这个属性值为null，整个模型对象依然会被创建，其他正确的属性也能正常绑定。之后你可以通过ModelState检查哪些属性出了问题，再做对应处理。
• 配置JSON序列化器保留错误信息：在Program.cs里配置控制器的JSON选项，开启输入格式化器的错误消息，这样即使模型为null，ModelState里也会记录具体的反序列化错误：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 允许将反序列化错误消息添加到ModelState
        options.AllowInputFormatterExceptionMessages = true;
    });

之后在控制器里就可以通过ModelState获取到具体的错误原因，比如"无法将字符串'asdf'转换为类型'System.Int32'"。

• 自定义模型绑定器（进阶）：如果你的业务场景需要更灵活的绑定逻辑，可以自定义模型绑定器，在绑定过程中手动处理类型转换错误，实现部分绑定的效果。

举个实际例子，假设你的模型是：

public class Client
{
    public int? Age { get; set; }
    public DateTime? RegistrationDate { get; set; }
    public string Name { get; set; }
}

当客户端提交这样的JSON：

{
    "Name": "Nicolas",
    "Age": "asdf",
    "RegistrationDate": "2024-05-20"
}

此时client参数不会是null，Name和RegistrationDate会正确绑定，Age会是null，同时ModelState.IsValid会是false，你可以在控制器里返回BadRequest(ModelState)把错误反馈给客户端。

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