自定义模型验证特性：如何访问验证错误并全局应用

我来给你捋捋具体的实现思路和代码，核心是利用ASP.NET Core的Action过滤器来拦截模型验证逻辑，既可以应用在控制器类级别，又能轻松访问到验证错误并返回自定义JSON结构。

核心思路 #

[ApiController]的默认验证逻辑是通过ModelStateInvalidFilter实现的，我们可以自己写一个自定义过滤器，替代（或补充）这个默认逻辑：

1. 用ActionFilterAttribute实现过滤器，它支持类级别标注，自动作用于控制器下所有方法
2. 在过滤器的执行前逻辑里，通过上下文对象直接访问ModelState获取验证错误
3. 把错误整理成你需要的Error数组格式，构造自定义JSON响应返回

具体代码实现 #

1. 自定义验证过滤器 #

这个过滤器会在每个Action执行前检查模型状态，一旦验证失败就返回自定义响应：

using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.Filters;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

public class CustomValidationFilterAttribute : ActionFilterAttribute
{
    public override async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
    {
        // 检查模型验证是否失败
        if (!context.ModelState.IsValid)
        {
            // 提取所有验证错误，整理成Error数组
            var validationErrors = context.ModelState
                .Where(kv => kv.Value.Errors.Any())
                .SelectMany(kv => kv.Value.Errors)
                .Select(error => error.ErrorMessage)
                .ToList();

            // 构造你想要的自定义响应结构
            var customResponse = new
            {
                Success = false,
                Errors = validationErrors
            };

            // 返回400状态码+自定义JSON，和ApiController默认状态码保持一致
            context.Result = new JsonResult(customResponse)
            {
                StatusCode = StatusCodes.Status400BadRequest
            };

            // 终止后续Action执行，直接返回响应
            return;
        }

        // 验证通过，继续执行原Action逻辑
        await next();
    }
}

2. 在控制器类上应用特性 #

需要关闭[ApiController]的默认验证过滤器，避免重复处理，然后添加我们的自定义过滤器：

// 关闭ApiController自带的验证过滤器，用我们自己的替代
[ApiController(SuppressModelStateInvalidFilter = true)]
// 类级别添加，作用于控制器下所有Action
[CustomValidationFilter]
[Route("api/[controller]")]
public class UserController : ControllerBase
{
    [HttpPost("register")]
    public IActionResult Register([FromBody] UserRegisterModel model)
    {
        // 这里不用再手动检查ModelState，过滤器已经处理了验证失败的情况
        return Ok(new { Success = true, Message = "注册成功" });
    }
}

// 测试用的模型类
public class UserRegisterModel
{
    [Required(ErrorMessage = "用户名不能为空")]
    public string Username { get; set; }

    [EmailAddress(ErrorMessage = "邮箱格式不正确")]
    public string Email { get; set; }

    [MinLength(6, ErrorMessage = "密码长度不能少于6位")]
    public string Password { get; set; }
}

3. 可选：全局配置（无需每个控制器加特性） #

如果想让所有控制器都自动使用这个验证逻辑，可以在Program.cs里全局配置：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers(options =>
{
    // 全局关闭默认的模型验证过滤器
    options.SuppressModelStateInvalidFilter = true;
    // 全局添加自定义过滤器，所有控制器自动生效
    options.Filters.Add<CustomValidationFilterAttribute>();
});

关键细节说明 #

• 访问验证错误的方式：通过ActionExecutingContext.ModelState直接获取，这个上下文对象包含了当前请求所有模型的验证状态，所有错误都存在ModelState.Values.Errors里
• 类级别特性的作用：ActionFilterAttribute标注在控制器类上时，会自动应用到该类下的所有Action方法，无需逐个添加
• 状态码保持一致：返回400 Bad Request和[ApiController]的默认行为一致，符合REST规范

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