如何使用Entity Framework验证Team名称的唯一性？

针对你的需求，这里提供几种实用的实现方式，兼顾数据可靠性和业务友好性：

1. 数据库层面添加唯一约束（最可靠） #

数据库级别的唯一约束是保障数据唯一性的最后防线，能防止任何绕过业务代码的操作（比如直接修改数据库）。通过EF的Fluent API在DbContext中配置：

public class TeamContext : DbContext
{
    public DbSet<Team> Team { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 为Team的Name字段创建唯一索引
        modelBuilder.Entity<Team>()
            .HasIndex(t => t.Name)
            .IsUnique();
    }
}

执行数据库迁移后，数据库会自动为Name字段创建唯一索引。当插入重复名称时，EF会抛出DbUpdateException，你可以在业务层捕获并处理这个异常。

2. 业务逻辑层提前校验（友好提示） #

在Repository的AddTeam方法中，先查询是否存在同名Team，提前给出明确的错误提示：

public void AddTeam(Team team)
{
    // 忽略大小写的检查，可根据业务需求调整StringComparison规则
    var exists = _teamContext.Team.Any(t => t.Name.Equals(team.Name, StringComparison.OrdinalIgnoreCase));
    if (exists)
    {
        throw new InvalidOperationException($"已存在名称为「{team.Name}」的Team");
    }

    team.Id = Guid.NewGuid();
    _teamContext.Team.Add(team);
}

⚠️ 注意：这种方式无法处理并发场景（比如两个请求同时插入同名Team），所以必须配合数据库唯一约束一起使用，避免数据不一致。

3. 并发冲突的异常处理 #

即使做了提前校验，并发场景下仍可能触发数据库唯一约束的冲突。在调用SaveChanges的地方捕获异常并转换为业务友好的错误：

try
{
    myRepository.AddTeam(newTeam);
    teamContext.SaveChanges();
}
catch (DbUpdateException ex)
{
    // 针对SQL Server的唯一约束冲突错误码（2601/2627），其他数据库需调整判断逻辑
    if (ex.InnerException is SqlException sqlEx && (sqlEx.Number == 2601 || sqlEx.Number == 2627))
    {
        throw new InvalidOperationException("Team名称已存在，请更换名称", ex);
    }
    // 其他异常原样抛出
    throw;
}

方案选择建议 #

优先组合使用数据库唯一约束+业务层校验+异常处理，既保证数据绝对可靠，又能给用户友好的错误提示；不建议单独使用业务层校验，无法应对并发场景下的数据冲突。

内容的提问来源于stack exchange，提问作者Czesław Nowicki