如何为API的Customer模型自定义EF Core验证错误信息？

1. 直接在模型上通过数据注解定义自定义错误 #

在Customer模型的必填字段上，使用[Required]属性指定自定义错误信息，ASP.NET Core的模型验证会自动识别并返回这些信息：

public class Customer
{
    public int Id { get; set; }

    [Required(ErrorMessage = "客户姓名不能为空，请填写姓名")]
    public string Name { get; set; }

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

2. 配合Fluent API（若偏好脱离模型注解） #

如果习惯用Fluent API配置EF Core实体约束，可在DbContext中定义字段非空，同时保留数据注解的错误信息配置（Fluent API仅负责数据库层面约束，验证错误仍需数据注解或全局处理）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Customer>()
        .Property(c => c.Name)
        .IsRequired();

    modelBuilder.Entity<Customer>()
        .Property(c => c.Email)
        .IsRequired();
}

3. 修正Post方法的验证逻辑 #

之前手动验证无效，大概率是未正确触发模型状态检查。正确的Post方法应在保存数据前先验证模型：

[HttpPost]
public async Task<IActionResult> CreateCustomer(Customer customer)
{
    if (!ModelState.IsValid)
    {
        // 直接返回包含自定义错误的响应
        return BadRequest(ModelState);
    }

    _context.Customers.Add(customer);
    await _context.SaveChangesAsync();

    return CreatedAtAction(nameof(GetCustomer), new { id = customer.Id }, customer);
}

注：必须在SaveChangesAsync()前检查ModelState.IsValid，否则EF Core会先抛出内置数据库约束错误。

4. 全局统一错误处理（可选） #

若想避免每个接口重复写验证逻辑，可添加全局过滤器统一处理所有模型验证错误：

public class ValidationFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        if (!context.ModelState.IsValid)
        {
            var errors = context.ModelState
                .Values
                .SelectMany(v => v.Errors)
                .Select(e => e.ErrorMessage)
                .ToList();

            context.Result = new BadRequestObjectResult(new 
            { 
                Message = "输入验证失败", 
                Errors = errors 
            });
        }
    }

    public void OnActionExecuted(ActionExecutedContext context) { }
}

在Program.cs中注册过滤器：

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

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