如何在SuppressModelStateInvalidFilter=true时复用内置语法验证并自定义响应

问题背景 #

当SuppressModelStateInvalidFilter设为false时，ASP.NET Core会自动完成模型验证但返回通用格式的错误响应。想要复用这套内置的验证逻辑（包括数据注解、参数语法校验等），同时返回自定义结构的响应。目前自行实现了IsModelValid函数，但需要整合ModelStateInvalidFilter内置的语法验证逻辑。

最优实现方案 #

不需要手动实现验证逻辑，直接复用ASP.NET Core内置的ModelState机制即可，步骤如下：

1. 禁用默认的通用响应过滤器
   在Program.cs（.NET 6+）中配置ApiBehaviorOptions，关闭默认的ModelStateInvalidFilter，避免系统自动返回通用响应：

builder.Services.Configure<ApiBehaviorOptions>(options =>
{
    options.SuppressModelStateInvalidFilter = true;
});

2. 自定义验证结果处理逻辑
   可以选择全局过滤器或控制器内局部处理两种方式：

方式一：全局过滤器（推荐，统一处理所有接口）

创建自定义Action过滤器，在请求执行前检查ModelState并返回自定义响应：

public class CustomModelValidationFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        if (!context.ModelState.IsValid)
        {
            // 构造自定义错误响应结构
            var errorDetails = context.ModelState
                .Where(kvp => kvp.Value.Errors.Any())
                .ToDictionary(
                    kvp => kvp.Key,
                    kvp => kvp.Value.Errors.Select(e => e.ErrorMessage).ToArray()
                );

            var customResponse = new
            {
                Code = 400,
                Message = "请求参数验证失败",
                Errors = errorDetails
            };

            context.Result = new JsonResult(customResponse)
            {
                StatusCode = StatusCodes.Status400BadRequest
            };
        }
    }

    public void OnActionExecuted(ActionExecutedContext context) { }
}

然后注册这个全局过滤器：

builder.Services.AddControllers(options =>
{
    options.Filters.Add<CustomModelValidationFilter>();
});

方式二：控制器内局部处理

如果只需要针对特定接口处理，直接在控制器方法中检查ModelState：

[HttpPost("create")]
public IActionResult CreateEntity([FromBody] YourModel model)
{
    if (!ModelState.IsValid)
    {
        var errorDetails = ModelState
            .Where(kvp => kvp.Value.Errors.Any())
            .ToDictionary(
                kvp => kvp.Key,
                kvp => kvp.Value.Errors.Select(e => e.ErrorMessage).ToArray()
            );

        return BadRequest(new
        {
            Code = 400,
            Message = "参数格式或内容不符合要求",
            Errors = errorDetails
        });
    }

    // 后续业务逻辑处理
    return Ok(new { Message = "创建成功" });
}

为什么不需要自行实现IsModelValid #

ASP.NET Core的ModelState已经自动整合了所有内置验证逻辑，包括：

• 数据注解验证（如[Required]、[StringLength]等）
• 参数类型转换错误（如字符串转整数失败）
• JSON/表单格式错误
• 模型绑定过程中的其他异常

这些正是ModelStateInvalidFilter原本要处理的内容，直接复用ModelState.IsValid就能覆盖所有场景，无需手动调用DataAnnotationsValidator。

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