EF Core多对多关联时IDENTITY_INSERT关闭引发插入异常

核心原因 #

EF Core 将已存在的 EventCategory 实体错误标记为 Added（待插入）状态，导致尝试向自增主键列插入显式值，触发 IDENTITY_INSERT 相关异常。这本质是因为关联的分类实体未被当前 DbContext 追踪，EF Core 误将其识别为新实体。

可能的触发场景及解决方法 #

1. 查询分类时未启用追踪 #

如果你的 DbContext 全局配置了无追踪查询（比如通过 UseQueryTrackingBehavior(QueryTrackingBehavior.NoTracking)），或者查询时隐式使用了无追踪模式，获取到的 EventCategory 实体不会被当前上下文追踪。此时添加关联的 EventItem 时，EF Core 会递归标记所有未追踪的关联实体为待插入。

解决方法：查询分类时显式启用追踪：

var selectedEventCategories = dbcontext.EventCategories
    .AsTracking() // 强制启用追踪
    .Where(c => selectedCategoryIds.Contains(c.EventCategoryId))
    .ToList();

2. 手动修正实体状态 #

如果无法修改查询方式，可在添加 EventItem 后，手动将关联分类的状态设置为 Unchanged，告知 EF Core 这些实体已存在于数据库：

await dbcontext.EventItems.AddAsync(newEventItem);

// 修正分类实体状态
foreach (var category in selectedEventCategories)
{
    dbcontext.Entry(category).State = EntityState.Unchanged;
}

await dbcontext.SaveChangesAsync();

3. 多对多关系未正确配置 #

EF Core 6 虽支持自动识别无中间实体的多对多关系，但如果实体结构或上下文配置存在问题，可能导致关系识别异常。

解决方法：在 DbContext 的 OnModelCreating 方法中显式配置多对多关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<EventItem>()
        .HasMany(e => e.EventCategories)
        .WithMany(c => c.EventItems)
        .UsingEntity(j => j.ToTable("EventItemCategory")); // 可选：指定中间表名称
}

4. 上下文未注册实体的 DbSet #

若 DbContext 中未声明 EventCategory 的 DbSet，EF Core 可能无法正确追踪该实体类型。

解决方法：在 DbContext 中添加对应的 DbSet 属性：

public DbSet<EventItem> EventItems { get; set; }
public DbSet<EventCategory> EventCategories { get; set; }

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