能否在Minimal API中手动接入模型验证机制？

完全可以手动为Minimal API接入基于[Required]这类DataAnnotations特性的模型验证，不需要依赖FluentValidation等第三方工具，以下是具体实现方式：

1. 手动在端点内实现验证 #

直接使用.NET内置的Validator.TryValidateObject方法对模型进行验证，无需额外依赖：

步骤1：定义带验证特性的模型 #

using System.ComponentModel.DataAnnotations;

public class CreateUserRequest
{
    [Required(ErrorMessage = "用户名不能为空")]
    [StringLength(20, ErrorMessage = "用户名长度不能超过20个字符")]
    public string Username { get; set; }

    [Required(ErrorMessage = "邮箱地址不能为空")]
    [EmailAddress(ErrorMessage = "请输入有效的邮箱格式")]
    public string Email { get; set; }
}

步骤2：在端点中添加验证逻辑 #

app.MapPost("/users", (CreateUserRequest request) =>
{
    var validationContext = new ValidationContext(request);
    var validationErrors = new List<ValidationResult>();
    
    // 执行验证，validateAllProperties确保校验所有特性
    bool isValid = Validator.TryValidateObject(request, validationContext, validationErrors, validateAllProperties: true);
    
    if (!isValid)
    {
        // 将错误转换为ValidationProblem所需的格式
        var errorDictionary = validationErrors.ToDictionary(
            err => err.MemberNames.FirstOrDefault() ?? string.Empty,
            err => new[] { err.ErrorMessage }
        );
        return Results.ValidationProblem(errorDictionary);
    }

    // 验证通过后执行业务逻辑
    return Results.Ok($"用户 {request.Username} 创建成功");
});

2. 封装扩展方法复用验证逻辑 #

如果多个端点都需要验证，可以封装成扩展方法，避免重复代码：

定义扩展方法 #

using System.ComponentModel.DataAnnotations;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;

public static class MinimalApiValidationExtensions
{
    public static RouteHandlerBuilder WithModelValidation<T>(this RouteHandlerBuilder builder)
    {
        builder.AddEndpointFilter(async (context, next) =>
        {
            // 从端点参数中获取待验证的模型
            var model = context.Arguments.OfType<T>().FirstOrDefault();
            if (model == null)
            {
                return Results.BadRequest("请求数据格式无效");
            }

            var validationContext = new ValidationContext(model);
            var validationErrors = new List<ValidationResult>();
            
            bool isValid = Validator.TryValidateObject(model, validationContext, validationErrors, validateAllProperties: true);
            
            if (!isValid)
            {
                var errorDictionary = validationErrors.ToDictionary(
                    err => err.MemberNames.FirstOrDefault() ?? string.Empty,
                    err => new[] { err.ErrorMessage }
                );
                return Results.ValidationProblem(errorDictionary);
            }

            // 验证通过，继续执行端点逻辑
            return await next(context);
        });
        return builder;
    }
}

在端点中使用扩展方法 #

app.MapPost("/users", (CreateUserRequest request) =>
{
    // 执行业务逻辑
    return Results.Ok($"用户 {request.Username} 创建成功");
})
.WithModelValidation<CreateUserRequest>(); // 一键添加验证

app.MapPut("/users/{id}", (int id, UpdateUserRequest request) =>
{
    // 执行业务逻辑
    return Results.Ok($"用户 {id} 更新成功");
})
.WithModelValidation<UpdateUserRequest>();

关于FluentValidation的补充 #

FluentValidation是可选方案，适合复杂的、自定义规则较多的验证场景，它提供了更灵活的链式语法，但并非必须。如果你的验证需求仅基于DataAnnotations特性，手动实现完全足够，且无需引入额外依赖。

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