如何解决Minimal API项目中的邮箱验证失效问题？

Minimal API确实不支持控制器模式下依赖IModelValidator的[EmailAddress]特性自动验证，下面是几种可行的解决方式：

方案1：手动使用邮箱验证库 #

先安装jstedfast/EmailValidation NuGet包：

Install-Package EmailValidation

然后在Minimal API端点里直接调用验证逻辑，手动返回错误：

app.MapPost("/user", (UserRequest request) =>
{
    if (!EmailValidator.Validate(request.Email, allowInternational: true))
    {
        return Results.Problem(
            detail: "邮箱格式不正确",
            statusCode: StatusCodes.Status400BadRequest,
            title: "验证失败");
    }

    // 后续业务逻辑
    return Results.Ok("操作成功");
});

public class UserRequest
{
    public string Email { get; set; }
}

这种方式简单直接，适合简单的验证场景。

方案2：使用FluentValidation集成验证 #

FluentValidation对Minimal API有良好的支持，能实现更灵活的验证规则：

1. 安装相关NuGet包：

Install-Package FluentValidation
Install-Package FluentValidation.AspNetCore

2. 定义验证器：

public class UserRequestValidator : AbstractValidator<UserRequest>
{
    public UserRequestValidator()
    {
        RuleFor(x => x.Email)
            .NotEmpty().WithMessage("邮箱不能为空")
            .EmailAddress().WithMessage("邮箱格式不正确");
    }
}

3. 在Program.cs中注册验证器并启用：

builder.Services.AddValidatorsFromAssemblyContaining<UserRequestValidator>();

var app = builder.Build();

app.MapPost("/user", async (UserRequest request, IValidator<UserRequest> validator) =>
{
    var validationResult = await validator.ValidateAsync(request);
    if (!validationResult.IsValid)
    {
        return Results.ValidationProblem(validationResult.ToDictionary());
    }

    // 业务逻辑
    return Results.Ok();
});

这种方式适合需要多字段复杂验证的场景，返回的错误格式也符合规范的ValidationProblem格式。

方案3：自定义端点过滤器实现特性验证 #

如果想保留特性标记的方式，可以自定义一个端点过滤器来处理：

1. 自定义[Email]特性：

public class EmailAttribute : Attribute
{
    public string ErrorMessage { get; set; } = "邮箱格式不正确";
}

2. 编写端点过滤器：

public class EmailValidationFilter : IEndpointFilter
{
    public async ValueTask<object?> InvokeAsync(EndpointFilterInvocationContext context, EndpointFilterDelegate next)
    {
        // 遍历所有参数，检查带有[Email]特性的属性
        foreach (var parameter in context.Arguments)
        {
            if (parameter == null) continue;
            
            var properties = parameter.GetType().GetProperties()
                .Where(p => p.GetCustomAttributes(typeof(EmailAttribute), false).Any());
            
            foreach (var prop in properties)
            {
                var emailValue = prop.GetValue(parameter) as string;
                var emailAttr = prop.GetCustomAttribute<EmailAttribute>();
                
                if (!string.IsNullOrEmpty(emailValue) && !EmailValidator.Validate(emailValue))
                {
                    return Results.Problem(
                        detail: emailAttr?.ErrorMessage,
                        statusCode: StatusCodes.Status400BadRequest);
                }
            }
        }

        return await next(context);
    }
}

3. 注册过滤器并使用：

// 全局注册（可选）
builder.Services.AddScoped<EmailValidationFilter>();

// 在端点上使用
app.MapPost("/user", (UserRequest request) =>
{
    // 业务逻辑
    return Results.Ok();
}).AddEndpointFilter<EmailValidationFilter>();

public class UserRequest
{
    [Email(ErrorMessage = "请输入有效的邮箱地址")]
    public string Email { get; set; }
}

这种方式可以复用验证逻辑，同时保留特性标记的直观性。

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