Entity Framework配置非唯一外键报重复键错误解决方法

EF Core默认将你当前的实体关系识别为一对一关联，而非你预期的多对一（一个Location可对应多个Person）关联。框架会自动为一对一关联的外键创建唯一索引IX_Persons_LocationId，限制同一个LocationId只能在Person表中出现一次，因此插入第二条关联相同Location的Person数据时会触发重复键报错。

你不需要使用中间映射表——映射表是多对多关联场景的方案，你要实现的是标准的多对一/一对多关联，直接配置关系类型即可。

二选一即可，配置完成后必须生成新的迁移并更新数据库，删除数据库中已存在的唯一索引，否则代码配置生效后数据库层面仍会报错。

方案1：数据注解配置 #

给实体补充导航属性，明确关联关系：

public class Person {
   public int PersonId {get;set;}
   public int? LocationId {get;set;}
   public string Name {get;set;}
   [ForeignKey("LocationId")]
   public Location Location {get;set;}
}

public class Location {
   public int LocationId {get;set;}
   public string Name {get;set;}
   public List<Person> People {get;set;}
}

Location中的People集合导航属性会明确告知EF Core这是一对多关联的「多」端承载，框架不会再为外键创建唯一索引。

方案2：Fluent API配置（无需修改实体类） #

如果不想在实体中加导航属性，直接在OnModelCreating中手动指定关联规则、修改索引配置即可——你之前没找到的外键唯一配置是在索引层面，不是外键配置段：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 显式配置一对多关系
    modelBuilder.Entity<Person>()
        .HasOne<Location>()
        .WithMany()
        .HasForeignKey(p => p.LocationId)
        .IsRequired(false); // 外键可空，若LocationId非int?类型则传true

    // 将外键上的唯一索引改为普通非唯一索引
    modelBuilder.Entity<Person>()
        .HasIndex(p => p.LocationId)
        .IsUnique(false);
}

操作提示：生成迁移后记得检查迁移文件内容，确认IX_Persons_LocationId的创建逻辑是unique: false，旧的唯一索引会被自动删除重建。

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