.NET Core插入SQL表时Unique约束不生效及插入失败结果咨询

常见失效原因及解决步骤 #

• 未正确应用EF Core迁移：你在实体类添加[Index]特性后，没有生成迁移脚本并更新到数据库，该配置只会在迁移同步后才会在数据库层面创建真实的唯一索引。
  操作流程：
  1. 包管理器控制台执行：Add-Migration AddUserEmailUniqueIndex
  2. 检查生成的迁移文件中是否存在创建Email唯一索引的代码，确认无误后执行：Update-Database
  3. 若迁移执行失败，说明数据库中已存在重复的Email数据，先清理重复数据后再重新执行迁移。
• 命名空间引用错误：EF Core 5的[Index]特性属于Microsoft.EntityFrameworkCore命名空间，若引用了其他命名空间下的同名特性，配置不会生效。
• Email字段未设置非空约束：你当前实体类的Email属性为可空string类型，数据库中多个NULL值不会触发唯一约束，建议给Email属性添加[Required]特性，保证字段非空同时约束生效。

异常表现 #

当插入重复Email时，_dbContext.SaveChanges()会抛出DbUpdateException异常，其内部异常包含对应数据库的唯一约束冲突错误码（如SQL Server为2601/2627，MySQL为1062）。

代码适配（满足插入失败返回-1的需求） #

你需要对插入逻辑添加异常捕获，修改后的代码如下：

public int createUser(string firstName, string lastName, DateTime dateOfBirth, string email, string password)
{
    try
    {
        UserDAO user = new UserDAO
        {
            FirstName = firstName,
            LastName = lastName,
            DateOfBirth = dateOfBirth,
            Email = email,
            Password = password
        };

        _dbContext.Users.Add(user);
        _dbContext.SaveChanges();
        return user.Id;
    }
    catch (DbUpdateException ex) when (ex.InnerException is { } innerEx && 
        // 可根据你使用的数据库调整错误码判断逻辑，以下为SQL Server示例
        (innerEx.HResult == -2146232060 || innerEx.Message.Contains("IX_Users_Email")))
    {
        // 唯一约束冲突，返回-1
        return -1;
    }
    // 其他异常可根据业务需求选择抛出或做其他处理
    throw;
}

REST API返回建议 #

如果是对外提供的REST接口，捕获到唯一约束冲突时，推荐返回409 Conflict状态码，响应体中携带「邮箱已被注册」的业务提示即可。

内容的提问来源于stack exchange，提问作者Pârvănescu Stefan