如何在EF Core OnModelCreating中生成自定义唯一约束错误信息

第一步：调整唯一索引配置 #

你当前写的是Email和UserName的复合唯一索引，只有两个字段的组合值重复时才会触发约束，无法单独识别邮箱/用户名重复的场景。如果需要两个字段各自保持唯一，要分开创建独立唯一索引，同时给索引指定固定名称，方便后续异常识别：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.ApplyConfiguration(new UserEntityConfiguration());

    // 邮箱单独唯一索引
    modelBuilder.Entity<User>()
           .HasIndex(u => u.Email)
           .IsUnique()
           .HasDatabaseName("IX_User_Email_Unique");

    // 用户名单独唯一索引
    modelBuilder.Entity<User>()
           .HasIndex(u => u.UserName)
           .IsUnique()
           .HasDatabaseName("IX_User_UserName_Unique");
    
    // 如果确实需要保留两个字段的复合唯一约束，按下面写法加即可
    // modelBuilder.Entity<User>()
    //        .HasIndex(u => new { u.Email, u.UserName })
    //        .IsUnique()
    //        .HasDatabaseName("IX_User_Email_UserName_Unique");
}

修改完配置记得执行EF Core迁移更新数据库结构。

第二步：全局拦截数据库更新异常，返回自定义提示 #

唯一约束冲突时EF Core会抛出DbUpdateException，内部异常会携带触发冲突的索引信息，在ASP.NET Core中添加全局异常中间件统一处理即可，不需要在每个接口写重复判断：

// Program.cs中，把这段中间件注册到所有业务中间件（路由、鉴权、控制器映射等）的最前面
app.Use(async (context, next) =>
{
    try
    {
        await next();
    }
    catch (Microsoft.EntityFrameworkCore.DbUpdateException ex)
    {
        context.Response.StatusCode = StatusCodes.Status400BadRequest;
        context.Response.ContentType = "application/json";
        string errorTip = "数据提交冲突，请稍后重试";
        
        // 以SQL Server为例，唯一约束冲突的错误号为2601、2627
        if (ex.InnerException is Microsoft.Data.SqlClient.SqlException sqlEx 
            && sqlEx.Number is 2601 or 2627)
        {
            if (sqlEx.Message.Contains("IX_User_Email_Unique"))
                errorTip = "该邮箱已被注册，请更换邮箱";
            else if (sqlEx.Message.Contains("IX_User_UserName_Unique"))
                errorTip = "用户名已存在，请更换用户名";
            // 复合索引的判断分支按需添加即可
        }

        // 按照你项目的统一接口返回格式调整返回结构
        await context.Response.WriteAsJsonAsync(new
        {
            code = 400,
            message = errorTip
        });
    }
});

如果你用的是MySQL、PostgreSQL等其他数据库，唯一约束冲突的错误号、内部异常类型会有差异，对应调整异常判断逻辑即可，核心识别逻辑不变。

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