ASP.NET Core自动ModelState验证为何返回400而非422？如何配置修改？

架构老林

2026-8-28

为什么默认自动ModelState验证返回400而非422

ASP.NET Core 中标记[ApiController]的控制器会启用内置自动模型校验逻辑：当数据注解校验、模型绑定失败时，框架会自动返回ProblemDetails格式的400响应，这是框架的默认设计约定——默认将参数存在性、格式合法性校验失败归类为400 Bad Request范畴，而422 Unprocessable Entity的默认语义是请求格式合法、参数类型匹配，但参数值不符合业务规则，因此默认不会触发422响应。

如何配置让参数校验失败返回422，同时保持application/problem+json格式

不要通过自定义中间件重写响应的方式实现，直接在Program.cs中配置Api行为选项即可，代码如下：

builder.Services.AddControllers()
    .ConfigureApiBehaviorOptions(options =>
    {
        options.InvalidModelStateResponseFactory = context =>
        {
            var problemDetails = new ValidationProblemDetails(context.ModelState)
            {
                Status = StatusCodes.Status422UnprocessableEntity,
                Title = "One or more validation errors occurred."
            };

            return new UnprocessableEntityObjectResult(problemDetails)
            {
                ContentTypes = { "application/problem+json" }
            };
        };
    });

自定义配置后响应结构和默认不一致的解决方法

出现结构差异的核心原因是配置时手动构造了自定义错误对象、没有复用框架内置的ValidationProblemDetails类型。上面给出的配置代码直接使用框架原生的校验问题详情类型，和默认400响应使用的类型完全一致，仅修改状态码为422，最终响应的字段结构、错误明细填充逻辑和默认400响应完全对齐，不会出现结构差异。