ASP.NET Core 8.0 Web API中属性绑定失败导致整个DTO为null的问题及实现部分绑定的方案咨询

嗨，这个问题我之前做项目时也碰到过，一开始特别纳闷——明明只是某一个属性格式不对，怎么整个DTO直接变成null了？我来给你拆解下原因和可行的解决办法：

为什么会出现整个DTO为null的情况？ #

ASP.NET Core 8.0默认用System.Text.Json做JSON序列化/反序列化工具，它的默认策略是「严格反序列化」：当反序列化过程中遇到任何无法解析的属性（比如把字符串传给int类型、或者格式不符合要求的TimeOnly值），整个反序列化操作会直接失败，不会创建DTO实例，所以你的控制器参数就会是null。这些解析错误其实会被记录到ModelState里，但因为DTO是null，很容易让人误以为ModelState没报错。

这个默认行为是为了避免生成「半初始化」的对象，但在很多业务场景下，我们更希望保留正确的属性值，同时拿到具体的错误信息，这就需要我们修改配置。

实现部分绑定的具体方案 #

要让框架绑定有效属性、保留DTO实例并记录错误，你需要调整JSON序列化的错误处理策略，具体步骤如下：

1. 修改Program.cs中的JSON配置
   在注册Controllers的地方，添加JsonOptions配置，让每个对象属性在遇到解析错误时允许继续反序列化：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 可选：允许忽略JSON中未在DTO定义的字段，避免额外错误
        options.JsonSerializerOptions.AllowUnrecognizedFields = true;
        
        // 核心配置：为所有对象属性设置错误处理策略为允许继续解析
        options.JsonSerializerOptions.TypeInfoResolver = new DefaultJsonTypeInfoResolver
        {
            Modifiers =
            {
                typeInfo =>
                {
                    if (typeInfo.Kind == JsonTypeInfoKind.Object)
                    {
                        foreach (var property in typeInfo.Properties)
                        {
                            property.ErrorHandling = JsonPropertyErrorHandling.Allow;
                        }
                    }
                }
            }
        };
    });

2. 确保控制器/Action的ModelState验证生效
   你的控制器类应该已经标注了[ApiController]特性（默认模板会自动添加），这个特性会自动检查ModelState.IsValid，如果无效会直接返回400 Bad Request，并携带错误信息。如果没加的话，建议加上，或者在Action里手动检查：

[HttpPost]
public IActionResult CreateStudent([FromBody] StudentDto dto)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }
    // 后续业务逻辑处理
}

效果验证 #

配置完成后，当你POST包含错误属性的JSON时：

• DTO实例会被正常创建，所有能解析的属性都会被正确赋值
• 无法解析的属性会保留类型默认值（比如int的0、TimeOnly的默认值）
• ModelState里会添加对应的错误信息，比如「The value 'invalid-time' is not a valid TimeOnly.」

这样你就能既拿到有效的属性值，又能给客户端返回具体的错误提示了。

内容来源于stack exchange