FluentValidation自动验证：如何在特定场景下不抛出异常

方案一：针对特定接口禁用自动验证，手动执行验证 #

全局自动验证配置保持不变，给需要「验证但不终止请求」的接口添加FluentValidation自带的[DisableAutoValidation]特性，然后在Action内手动调用验证器，记录错误后继续处理请求。

示例代码 #

控制器Action：

[HttpPost]
[DisableAutoValidation] // 关闭该接口的自动验证
public IActionResult ProcessRequest([FromBody] MyRequestDto request)
{
    // 获取对应DTO的验证器
    var validator = HttpContext.RequestServices.GetRequiredService<IValidator<MyRequestDto>>();
    var validationResult = validator.Validate(request);

    // 记录验证错误
    if (!validationResult.IsValid)
    {
        foreach (var error in validationResult.Errors)
        {
            // 用项目中已有的日志组件记录错误，比如 _logger.LogError(error.ErrorMessage);
        }
    }

    // 继续正常处理请求逻辑
    return Ok("请求处理完成");
}

优点：实现简单，仅针对目标接口修改，不干扰全局验证规则。

方案二：自定义筛选器+特性标记，全局控制验证行为 #

创建自定义特性标记需要「验证不终止」的接口/控制器，替换FluentValidation默认的自动验证筛选器，在筛选器内根据特性判断是否返回错误响应。

步骤1：定义自定义特性 #

[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class)]
public class AllowValidationErrorsAttribute : Attribute
{
}

步骤2：实现自定义验证筛选器 #

继承FluentValidation的自动验证筛选器，添加自定义逻辑：

public class CustomFluentValidationFilter : FluentValidationAutoValidationFilter
{
    private readonly ILogger<CustomFluentValidationFilter> _logger;

    public CustomFluentValidationFilter(ILogger<CustomFluentValidationFilter> logger, IValidatorFactory validatorFactory) 
        : base(validatorFactory)
    {
        _logger = logger;
    }

    public override async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
    {
        // 检查当前Action或控制器是否标记了AllowValidationErrors特性
        var allowErrors = context.ActionDescriptor.EndpointMetadata.Any(m => m is AllowValidationErrorsAttribute);

        // 执行默认的验证逻辑
        await base.OnActionExecutionAsync(context, next);

        // 如果允许忽略错误且ModelState存在验证错误
        if (allowErrors && !context.ModelState.IsValid)
        {
            // 批量记录所有验证错误
            foreach (var key in context.ModelState.Keys)
            {
                foreach (var error in context.ModelState[key].Errors)
                {
                    _logger.LogError("验证错误：{Field} - {Message}", key, error.ErrorMessage);
                }
            }

            // 清除ModelState错误，让请求继续执行后续逻辑
            context.ModelState.Clear();
        }
    }
}

步骤3：替换默认筛选器并注册 #

在Program.cs中替换默认的FluentValidation筛选器，保留原有配置：

// 移除默认的FluentValidation自动验证筛选器工厂
services.RemoveAll<IFilterFactory>(service => 
    service.ImplementationType == typeof(FluentValidationAutoValidationFilterFactory));

// 注册自定义筛选器
services.AddScoped<IFilterFactory, ServiceFilterFactory>(sp => 
    new ServiceFilterFactory(typeof(CustomFluentValidationFilter)));

// 原有FluentValidation配置保持不变
services
    .AddFluentValidationAutoValidation()
    .AddValidatorsFromAssemblyContaining<Program>();

// InvalidModelStateFactory配置也保持不变
services.ConfigureApiBehaviorOptions(options =>
{
    options.InvalidModelStateResponseFactory = context =>
    {
        ValidationProblemDetails problemDetails = new(context.ModelState)
        {
            Title = "Validation Error",
            Type = "https://datatracker.ietf.org/doc/html/rfc7807",
            Status = StatusCodes.Status400BadRequest,
            Detail = "The request contained validation error(s)"
        };
        // 记录错误逻辑
        return new BadRequestObjectResult(problemDetails);
    };
});

步骤4：标记目标接口 #

给需要特殊处理的接口添加特性：

[HttpPost]
[AllowValidationErrors]
public IActionResult ProcessRequest([FromBody] MyRequestDto request)
{
    // 正常处理请求即可，ModelState已清除错误
    return Ok("请求处理完成");
}

优点：无需修改Action内部逻辑，仅通过特性标记即可控制验证行为，适合多个接口需要特殊处理的场景。

方案三：重写ValidatorInterceptor（细粒度控制） #

如果需要针对单个验证规则、特定DTO或路由做更细粒度的控制，可以实现IValidatorInterceptor，在验证完成后决定是否抛出异常。

示例代码 #

1. 实现拦截器：

public class CustomValidatorInterceptor : IValidatorInterceptor
{
    private readonly ILogger<CustomValidatorInterceptor> _logger;

    public CustomValidatorInterceptor(ILogger<CustomValidatorInterceptor> logger)
    {
        _logger = logger;
    }

    public ValidationContext BeforeMvcValidation(ControllerContext controllerContext, ValidationContext validationContext)
    {
        return validationContext;
    }

    public ValidationResult AfterMvcValidation(ControllerContext controllerContext, ValidationContext validationContext, ValidationResult result)
    {
        // 根据路由、控制器/Action名称判断是否允许忽略错误
        var isAllowErrors = controllerContext.ActionDescriptor.RouteValues["action"] == "ProcessRequest";

        if (isAllowErrors && !result.IsValid)
        {
            // 记录验证错误
            foreach (var error in result.Errors)
            {
                _logger.LogError("验证错误：{Property} - {Message}", error.PropertyName, error.ErrorMessage);
            }

            // 返回空的有效结果，让自动验证流程不触发错误响应
            return new ValidationResult();
        }

        return result;
    }
}

2. 在Program.cs中注册拦截器：

services.AddScoped<IValidatorInterceptor, CustomValidatorInterceptor>();

// 原有FluentValidation配置保持不变
services
    .AddFluentValidationAutoValidation()
    .AddValidatorsFromAssemblyContaining<Program>();

优点：支持更灵活的规则判断，适合复杂场景下的验证行为控制。

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