EF Core 配置Person与Title一对一关系触发Persons表唯一索引重复错误

报错诱因定位 #

• 核心配置错误：当前实体配置采用了HasOne().WithOne()的一对一映射，EF Core会自动为外键Person.TitleId生成唯一索引IX_Persons_TitleId，强制要求每个Title最多关联一条Person记录。但实际业务中Title是通用称谓（Mr/Mrs/Dr可被多人使用），本就该是一对多关系。
• 变更跟踪逻辑触发级联插入：你在保存新Person时，手动加载了已存在于数据库的Title对象并赋值给导航属性。当执行Add操作时，EF会把整个对象图的所有实体默认设置为Added状态，哪怕Title是已存在的记录，它内部导航属性关联的已存在Person也会被级联判定为待插入，最终尝试插入另一条TitleId=1的Person记录，直接撞上唯一索引约束。
• 配置笔误：PersonEntityConfiguration的Configure方法参数泛型写为EntityTypeBuilder<Doctor>，但类实现的是IEntityTypeConfiguration<Person>，这会导致实体配置完全不生效，后续还会出现其他非预期行为。

针对性解决方案 #

1. 修正实体关系配置 #

按照真实业务的一对多逻辑调整映射，同时修正泛型笔误：

public class PersonEntityConfiguration : IEntityTypeConfiguration<Person>
{
    public void Configure(EntityTypeBuilder<Person> builder)
    {
        builder.ToTable("Persons");
        builder.HasKey(c => c.Id);
        // 调整为一个Title可对应多个Person
        builder.HasOne(c => c.Title)
          .WithMany(c => c.Person)
          .HasForeignKey<Person>(cc => cc.TitleId)
          .OnDelete(DeleteBehavior.Restrict);
    }
}

调整后EF不会再为TitleId生成唯一索引，从根源上消除同TitleId可被多人关联的约束冲突。

2. 优化保存时的跟踪逻辑 #

两种方案二选一，避免级联插入已存在的关联实体：

• 方案一：不加载完整Title实体，仅校验TitleId合法性后直接赋值外键

  // 替换原来加载Title对象的逻辑
  bool titleExists = await _titleRepository.AnyAsync(t => t.Id == person.TitleId);
  if (!titleExists) throw new InvalidOperationException("关联的称谓不存在");
  _dbContext.Set<Person>().Add(person);
  await _dbContext.SaveChangesAsync();
  

• 方案二：如果必须保留Title导航属性的赋值，显式标记该实体的跟踪状态

  Title title = await _titleRepository.GettitleById(person.TitleId);
  person.Title = title;
  // 明确告知EF该Title为已存在记录，无需执行插入/更新操作
  _dbContext.Entry(title).State = EntityState.Unchanged;
  _dbContext.Set<Person>().Add(person);
  await _dbContext.SaveChangesAsync();
  

3. 循环引用的处理 #

你观察到的Person和Title互相嵌套的循环引用，在上述保存逻辑修正后不会再触发级联插入问题。如果是接口返回序列化时遇到循环引用，直接在Json序列化配置中开启循环引用忽略即可，不影响数据库操作。

特殊场景说明：如果业务确实要求一个Title只能绑定一个Person（比如专属称谓），那当前报错的本质是TitleId=1的关联记录已存在，再插入同关联的Person本身就违反唯一约束，和循环引用无关，需要在业务层增加重复校验逻辑。

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