EF多对多关联表插入时使用错误ContactId引发外键约束冲突的问题排查

从你的代码和日志来看，核心问题出在EF的实体状态跟踪和配置上，我来一步步帮你分析和解决：

问题根源拆解 #

1. ContactTypeId异常为0：日志里出现了SELECT TOP(1) [c].[Id], [c].[Name] FROM [ContactTypes] AS [c] WHERE [c].[Id] = 0的查询，说明你获取的vendorContactType是null，EF自动创建了一个默认的ContactType实例（Id为枚举默认值0），而数据库里根本没有这个Id的记录。
2. ContactId使用临时负数值：第二个Contact插入后，EF没有把数据库生成的真实Id赋值给实体，导致插入中间表ContactTypeXrefs时用了临时Id（-2147482646），这个值在Contacts表中不存在，直接触发外键约束冲突。

具体解决方案 #

1. 确保能正确获取Vendor类型的ContactType

先解决vendorContactType为null的问题：

• 检查ContactTypeEnum的枚举值是否和数据库中ContactTypes表的Id完全匹配，比如确认ContactTypeEnum.Vendor的数值和你种子数据里设置的一致。
• 把FirstOrDefault替换成First，这样如果找不到对应的ContactType会直接抛出异常，更早定位问题：

  var vendorContactType = Context.ContactTypes.First(ct => ct.Id == ContactTypeEnum.Vendor);
  

• 确认测试数据库已经应用了包含ContactType种子数据的迁移，或者在测试初始化阶段手动插入种子数据。

2. 配置Contact的Id为数据库生成并确保可赋值

EF需要主键属性可赋值（哪怕是private setter），才能在插入后把数据库生成的Id同步到实体：

• 如果你的EntityBase中Id是只读属性（没有setter），修改为包含private setter：

  public abstract class EntityBase
  {
      public int Id { get; private set; }
      // 其他审计/基础属性...
  }
  

• 在Contact的配置中显式声明Id由数据库自动生成：

  public void Configure(EntityTypeBuilder<Contact> builder)
  {
      builder.HasKey(x => x.Id);
      builder.Property(x => x.Id)
          .HasColumnOrder(0)
          .ValueGeneratedOnAdd(); // 明确告诉EF这个Id是数据库自增的
      // 其他属性、索引配置...
  }
  

3. 验证多对多关联配置的正确性

确认中间表的外键关联没有错误，特别是两个外键都正确指向对应表的主键：

builder.HasMany(x => x.ContactTypes)
    .WithMany()
    .UsingEntity<ContactTypeXref>(
        l => l.HasOne<ContactType>().WithMany().HasForeignKey(e => e.ContactTypeId)
            .OnDelete(DeleteBehavior.Restrict), // 防止误删ContactType导致关联数据异常
        r => r.HasOne<Contact>().WithMany().HasForeignKey(e => e.ContactId)
            .OnDelete(DeleteBehavior.Cascade), // 删除Contact时自动删除关联的中间表记录
        z => z.Property(e => e.Created).HasDefaultValueSql(SqlServerSysDatetimeOffset)
    );

4. 排查EF状态跟踪问题

如果上述步骤都没问题，可以尝试在添加第二个Contact前清理上下文的跟踪状态（仅用于排查，不推荐长期使用）：

// 在添加vendorContact前清理跟踪，排除状态混乱问题
Context.ChangeTracker.Clear();

如果这样能解决问题，说明测试中复用的DbContext出现了跟踪异常，建议每个测试方法都使用全新的DbContext实例。

验证测试 #

修改后可以先运行一个简单的单例测试，验证带Vendor类型的Contact能否正常插入：

[Fact]
public async Task AddVendorContact_ShouldSucceed()
{
    var vendorContactType = Context.ContactTypes.First(ct => ct.Id == ContactTypeEnum.Vendor);
    var vendorContact = new Contact
    {
        Name = "Test Vendor Contact",
        Address1 = "123 Another Street",
        IsActive = true,
        ContactTypes = new List<ContactType> { vendorContactType }
    };

    Context.Contacts.Add(vendorContact);
    await Context.SaveChangesAsync();

    // 验证Contact和关联记录都正确保存
    var savedContact = await Context.Contacts.Include(c => c.ContactTypes).FirstOrDefaultAsync(c => c.Id == vendorContact.Id);
    savedContact.ShouldNotBeNull();
    savedContact.ContactTypes.ShouldContain(ct => ct.Id == ContactTypeEnum.Vendor);
}

备注：内容来源于stack exchange，提问作者Killnine