.NET WebAPI如何全局对响应体进行类验证？

要实现像请求体自动验证那样的全局响应体验证，无需在每个端点编写重复逻辑，可以通过全局结果过滤器结合.NET自带的DataAnnotations验证器完成，具体步骤如下：

1. 创建响应体验证过滤器 #

实现一个继承自ResultFilterAttribute的过滤器，在响应返回前拦截并校验返回的DTO对象：

using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Mvc.Filters;
using Microsoft.AspNetCore.Mvc;

public class ValidateResponseFilter : ResultFilterAttribute
{
    public override void OnResultExecuting(ResultExecutingContext context)
    {
        // 只处理返回ObjectResult的情况（覆盖各类DTO返回场景）
        if (context.Result is ObjectResult objectResult && objectResult.Value != null)
        {
            var validationContext = new ValidationContext(objectResult.Value);
            var validationErrors = new List<ValidationResult>();

            // 触发所有验证规则（包括Required/MinLength/MaxLength等）
            var isValid = Validator.TryValidateObject(
                objectResult.Value, 
                validationContext, 
                validationErrors, 
                validateAllProperties: true
            );

            if (!isValid)
            {
                // 拼接错误信息并抛出验证异常
                var errorMsg = string.Join("; ", validationErrors.Select(e => e.ErrorMessage));
                throw new ValidationException($"响应体验证失败：{errorMsg}");

                // 若不想抛异常，也可以直接返回BadRequest响应并取消后续流程：
                // context.Result = new BadRequestObjectResult(validationErrors);
                // context.Cancel = true;
            }
        }

        base.OnResultExecuting(context);
    }
}

2. 注册全局过滤器 #

在Program.cs中将过滤器添加到控制器的全局配置中，所有控制器端点会自动应用该验证逻辑：

var builder = WebApplication.CreateBuilder(args);

// 添加控制器并注册全局响应验证过滤器
builder.Services.AddControllers(options =>
{
    options.Filters.Add<ValidateResponseFilter>();
});

var app = builder.Build();

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

3. 可选：跳过特定端点的验证 #

如果部分控制器或方法不需要响应体验证，可以定义一个跳过特性：

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

修改过滤器逻辑，检查是否存在该特性，存在则跳过验证：

public override void OnResultExecuting(ResultExecutingContext context)
{
    // 检查当前端点是否标记了跳过验证特性
    var needSkip = context.ActionDescriptor.EndpointMetadata
        .Any(m => m is SkipResponseValidationAttribute);
    
    if (needSkip)
    {
        base.OnResultExecuting(context);
        return;
    }

    // 原有的验证逻辑...
}

之后给不需要验证的控制器或方法添加[SkipResponseValidation]即可。

内容的提问来源于stack exchange，提问作者Joel'-'