ASP.NET Core Minimal API中ConfigureApiBehaviorOptions()的等效实现

结论 #

可以实现类似MVC中的集中式ModelState错误管理，Minimal API支持通过配置ApiBehaviorOptions统一处理模型验证失败的响应，无需在每个端点中重复编写验证逻辑。

实现步骤 #

1. 配置全局验证响应逻辑 #

在服务配置阶段，添加必要的支持服务并配置InvalidModelStateResponseFactory，指定模型验证失败时的默认响应：

var builder = WebApplication.CreateBuilder(args);

// 添加端点API探索服务，为ApiBehaviorOptions提供支持
builder.Services.AddEndpointsApiExplorer();

// 配置模型验证失败的全局响应
builder.Services.Configure<ApiBehaviorOptions>(options =>
{
    options.InvalidModelStateResponseFactory = actionContext =>
    {
        // 提取所有验证错误信息
        var errorDetails = actionContext.ModelState
            .Where(entry => entry.Value.Errors.Any())
            .SelectMany(entry => entry.Value.Errors)
            .Select(error => error.ErrorMessage)
            .ToList();

        // 返回422 Unprocessable Entity响应（可按需修改为其他状态码）
        return new UnprocessableEntityObjectResult(new
        {
            StatusCode = StatusCodes.Status422UnprocessableEntity,
            ValidationErrors = errorDetails
        });
    };
});

2. 定义带验证规则的DTO #

在DTO类上添加数据验证注解，框架会自动完成模型校验：

public class CreateProductDto
{
    [Required(ErrorMessage = "产品名称不能为空")]
    [StringLength(50, ErrorMessage = "产品名称不能超过50个字符")]
    public string Name { get; set; }

    [Range(0.01, double.MaxValue, ErrorMessage = "价格必须大于0")]
    public decimal Price { get; set; }
}

3. 编写Minimal API端点 #

在端点中直接使用DTO作为参数，无需手动检查ModelState，验证失败时会自动触发全局配置的响应：

var app = builder.Build();

app.MapPost("/products", (CreateProductDto productDto) =>
{
    // 仅当模型验证通过时，才会执行此处的业务逻辑
    return Results.Ok(new { Message = "产品创建成功", Product = productDto });
})
.WithName("CreateProduct")
.WithOpenApi();

app.Run();

补充说明 #

• 若需要更定制化的处理，也可以通过自定义中间件或端点过滤器实现全局验证，但ApiBehaviorOptions是最贴合MVC原有模式的方案。
• Minimal API的模型验证仅在参数绑定（如[FromBody]、[FromQuery]等）完成后自动触发，确保验证逻辑的集中性。

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