ASP.NET Core中如何使用FluentValidation校验基元类型参数

FluentValidation 默认的自动校验管线仅针对复杂类型模型生效，直接作为 Action 入参的基元类型（如int、string、DateTime等）不会被自动捕获校验——本质原因是同值类型的不同参数（比如示例中两个int类型参数）无法通过类型直接匹配对应校验器，需要手动补充参数和校验器的映射逻辑，就能实现和复杂类型完全一致的自动校验体验。

步骤1：定义参数与校验器的映射标记 #

首先定义一个参数级特性，用来明确标记每个基元参数对应使用的校验器，解决同类型参数无法区分校验规则的问题：

[AttributeUsage(AttributeTargets.Parameter, AllowMultiple = false)]
public class ValidateWithAttribute : Attribute
{
    public Type ValidatorType { get; }
    public ValidateWithAttribute(Type validatorType)
    {
        ValidatorType = validatorType;
    }
}

给需要校验的基元参数加上对应标记：

[HttpGet]
public IActionResult MyPublicEndpoint(
    [ValidateWith(typeof(AgeValidator))] int age, 
    [ValidateWith(typeof(RandomNumberValidator))] int randomNumber)
{
    // 端点业务逻辑
}

步骤2：实现基元类型自动校验过滤器 #

写一个全局动作过滤器，在Action执行前自动扫描带标记的参数，从依赖注入容器获取对应校验器执行校验，校验失败时直接写入ModelState返回400错误，和复杂类型的校验返回行为完全对齐：

public class PrimitiveTypeValidationFilter : IAsyncActionFilter
{
    private readonly IServiceProvider _serviceProvider;

    public PrimitiveTypeValidationFilter(IServiceProvider serviceProvider)
    {
        _serviceProvider = serviceProvider;
    }

    public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
    {
        foreach (var param in context.ActionDescriptor.Parameters)
        {
            if (!context.ActionArguments.TryGetValue(param.Name, out var paramValue))
                continue;
            
            // 读取参数上的校验标记
            var validateAttr = param.ParameterInfo.GetCustomAttribute<ValidateWithAttribute>();
            if (validateAttr == null)
                continue;

            // 获取校验器实例
            if (_serviceProvider.GetService(validateAttr.ValidatorType) is not IValidator validator)
                throw new InvalidOperationException($"类型 {validateAttr.ValidatorType.FullName} 未注册为校验器");

            // 执行校验
            var validateResult = await validator.ValidateAsync(new ValidationContext<object>(paramValue));
            // 错误写入ModelState
            foreach (var err in validateResult.Errors)
            {
                context.ModelState.AddModelError(param.Name, err.ErrorMessage);
            }
        }

        // 校验不通过直接返回400
        if (!context.ModelState.IsValid)
        {
            context.Result = new BadRequestObjectResult(context.ModelState);
            return;
        }

        await next();
    }
}

步骤3：注册服务与过滤器 #

在Program.cs（或旧版Startup的ConfigureServices方法）中，注册你写的校验器、全局过滤器即可，原有复杂类型的校验配置完全保留，不会产生冲突：

// 注册FluentValidation校验器，原有复杂类型的注册逻辑保留
builder.Services.AddFluentValidation(opt =>
{
    opt.RegisterValidatorsFromAssemblyContaining<AgeValidator>();
    // 原有其他配置比如ImplicitlyValidateChildProperties等可直接保留
});

// 注册基元校验过滤器，全局生效
builder.Services.Configure<MvcOptions>(opt =>
{
    opt.Filters.Add<PrimitiveTypeValidationFilter>();
});

差异化校验规则说明 #

因为每个基元参数通过[ValidateWith]特性明确绑定了独立的校验器，哪怕参数类型完全相同，也会执行对应校验器里的规则，不会出现规则混用的问题：

• 比如AgeValidator里写规则RuleFor(x => x).InclusiveBetween(18, 120).WithMessage("年龄必须在18-120岁之间")
• RandomNumberValidator里写规则RuleFor(x => x).InclusiveBetween(1, 100).WithMessage("随机数必须在1-100范围内")
  两个规则完全独立，互不影响。

如果你不想在参数上增加特性标记，也可以选择两种替代映射方式：

• 维护静态参数名-校验器类型字典：在过滤器内硬编码或从配置文件加载映射关系，按Action参数名匹配对应校验器，优点是不用修改Action方法签名，缺点是参数重命名时需要同步修改映射，容易遗漏
• 按命名约定自动匹配：比如约定参数名为xxx时，自动在已注册的校验器中查找名为XxxValidator的类型作为匹配校验器，灵活度高但需要团队统一命名规范，还要额外处理类型加载、重复类型的问题

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