如何自定义MVC内置验证中间件的响应格式？

• 已完成自定义异常处理中间件开发：可捕获API抛出的所有异常，按统一规则格式化响应返回给客户端，中间件内置的开发环境判断、调试信息附加、操作日志记录逻辑目前均运行正常。
• 现存问题：框架内置的请求参数验证中间件，在校验失败时生成的响应格式与自定义响应规则不匹配，无法保持全接口响应格式的统一性。
• 调整目标：完整保留内置验证的参数校验核心功能，仅替换验证失败时返回给客户端的响应结构、错误提示内容，无需改动原有校验规则。

{
  "message": "Validation error(s)",
  "details": [
    "The value '35353535353535353535353535353535353535353535' is not valid."
  ]
}

以ASP.NET Core内置验证中间件为例，框架本身预留了响应自定义入口，无需侵入原有校验逻辑即可完成格式统一，改造步骤如下：

1. 在服务注册阶段（Program.cs或Startup.cs中），找到控制器服务的配置代码段（AddControllers()的链式调用部分）
2. 新增ApiBehaviorOptions配置，重写InvalidModelStateResponseFactory委托，将默认的响应生成逻辑替换为和自定义规则匹配的结构
3. 配置完成后，所有内置参数校验触发的失败响应都会自动走自定义格式输出，完全不改动原有校验规则本身

参考实现代码：

builder.Services.AddControllers()
    .ConfigureApiBehaviorOptions(options =>
    {
        // 重写验证失败的响应生成逻辑
        options.InvalidModelStateResponseFactory = context =>
        {
            // 收集全量校验错误信息
            var errorDetails = context.ModelState
                .Where(entry => entry.Value.Errors.Any())
                .SelectMany(entry => entry.Value.Errors.Select(err => 
                    string.IsNullOrEmpty(err.ErrorMessage) 
                        ? $"字段 {entry.Key} 的值格式不合法" 
                        : err.ErrorMessage
                )).ToList();
            
            // 复用自定义中间件的统一响应结构组装返回内容
            var customResponse = new
            {
                code = 400,
                message = "请求参数校验失败",
                data = errorDetails,
                // 开发环境下附加调试信息，和自定义异常中间件逻辑保持一致
                debugInfo = builder.Environment.IsDevelopment() 
                    ? new { traceId = context.HttpContext.TraceIdentifier } 
                    : null
            };
            
            return new ObjectResult(customResponse)
            {
                StatusCode = StatusCodes.Status400BadRequest
            };
        };
    });

• 不要尝试在自定义异常中间件中拦截处理内置验证错误：内置验证逻辑是在中间件管道早期的模型绑定阶段直接生成响应返回，不会向上抛出可被异常中间件捕获的异常，这也是为什么异常中间件没有统一覆盖这部分响应的核心原因
• 重写响应逻辑时，可以直接复用自定义异常中间件中已经封装好的响应结构生成方法，避免重复写相同的序列化逻辑
• 自定义的扩展验证规则产生的错误，会自动进入上述配置的统一响应流程，不需要单独做格式适配

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