如何仅针对部分端点修改[ApiController]自动验证响应？

方案1：自定义特性+全局响应工厂扩展 #

这种方法通过扩展全局的InvalidModelStateResponseFactory，结合自定义特性判断，仅对标记了特性的端点返回自定义验证响应，不影响其他端点。

1. 定义自定义特性，用于标记需要修改响应的端点：

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

2. 在Program.cs中配置ApiBehaviorOptions，替换默认的响应工厂逻辑：

builder.Services.Configure<ApiBehaviorOptions>(options =>
{
    // 保存原始的响应工厂
    var originalResponseFactory = options.InvalidModelStateResponseFactory;
    
    options.InvalidModelStateResponseFactory = context =>
    {
        // 检查当前请求的端点是否标记了自定义特性
        var hasCustomAttribute = context.ActionDescriptor.EndpointMetadata
            .Any(meta => meta is CustomValidationResponseAttribute);

        if (hasCustomAttribute)
        {
            // 构建自定义的验证响应结构
            var validationErrors = context.ModelState
                .Where(kv => kv.Value.Errors.Any())
                .ToDictionary(
                    kv => kv.Key,
                    kv => kv.Value.Errors.Select(e => e.ErrorMessage).ToArray()
                );

            return new BadRequestObjectResult(new
            {
                Code = 400,
                Message = "参数验证失败",
                Errors = validationErrors
            });
        }

        // 未标记特性的端点，使用默认响应
        return originalResponseFactory(context);
    };
});

3. 在需要自定义响应的控制器或Action上标记特性：

[ApiController]
[Route("api/[controller]")]
public class MyController : ControllerBase
{
    [HttpPost("custom-validation")]
    [CustomValidationResponse] // 标记此端点使用自定义响应
    public IActionResult CustomValidationEndpoint(MyRequestModel model)
    {
        return Ok("处理成功");
    }

    [HttpPost("default-validation")]
    public IActionResult DefaultValidationEndpoint(MyRequestModel model)
    {
        return Ok("处理成功");
    }
}

方案2：禁用特定端点的自动验证，手动处理模型状态 #

直接禁用目标端点的自动验证过滤器，手动检查ModelState并返回自定义响应，适合需要完全控制验证逻辑的场景。

在目标Action上添加[SuppressModelStateInvalidFilter]特性，禁用自动验证后手动处理：

[ApiController]
[Route("api/[controller]")]
public class MyController : ControllerBase
{
    [HttpPost("manual-validation")]
    [SuppressModelStateInvalidFilter] // 禁用自动验证
    public IActionResult ManualValidationEndpoint(MyRequestModel model)
    {
        // 手动检查模型状态
        if (!ModelState.IsValid)
        {
            // 构建自定义响应
            var customResponse = new
            {
                Status = "ValidationFailed",
                Details = ModelState.Values
                    .SelectMany(v => v.Errors)
                    .Select(e => e.ErrorMessage)
                    .ToList()
            };
            return BadRequest(customResponse);
        }

        // 正常业务逻辑处理
        return Ok("处理成功");
    }
}

[SuppressModelStateInvalidFilter]是ASP.NET Core内置特性，专门用于禁用特定端点的自动模型状态验证过滤器。

方案3：利用ActionFilter拦截并修改响应 #

通过IActionFilter的OnActionExecuted方法，拦截自动验证生成的响应，仅对标记了特性的端点替换为自定义响应。

1. 定义自定义特性和过滤器：

// 标记特性
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)]
public class CustomValidationResponseAttribute : Attribute
{
}

// 自定义过滤器
public class CustomValidationResponseFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        // 动作执行前的逻辑（此处无需处理）
    }

    public void OnActionExecuted(ActionExecutedContext context)
    {
        // 检查是否是自动验证返回的BadRequest，且端点标记了自定义特性
        if (context.Result is BadRequestObjectResult badRequestResult 
            && !context.ModelState.IsValid
            && context.ActionDescriptor.EndpointMetadata.Any(meta => meta is CustomValidationResponseAttribute))
        {
            // 替换为自定义响应
            var errors = context.ModelState
                .Where(kv => kv.Value.Errors.Any())
                .ToDictionary(kv => kv.Key, kv => kv.Value.Errors.Select(e => e.ErrorMessage));

            context.Result = new BadRequestObjectResult(new
            {
                Success = false,
                ValidationErrors = errors
            });
        }
    }
}

2. 在Program.cs中注册过滤器：

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

3. 在目标端点上标记特性：

[HttpPost("filter-based")]
[CustomValidationResponse]
public IActionResult FilterBasedEndpoint(MyRequestModel model)
{
    return Ok("处理成功");
}

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