EF Core 6 TPT模式插入带主键实体报IDENTITY_INSERT为OFF错误

问题场景 #

• 迁移场景：将原有基于.NET Framework + EF6的应用迁移至.NET 6 + EF Core 6环境，业务模型采用TPT（每个类型对应独立表）继承映射方案
• 异常现象：客户端生成模型实例时，主键字段会默认携带随机int类型初始值，调用SaveChanges/SaveChangesAsync执行插入时抛出如下错误：

Cannot insert explicit value for identity column in table 'TPTUsers' when IDENTITY_INSERT is set to OFF

• 已验证无效方案：单独配置ValueGeneratedOnAdd、UseIdentityColumn、保存前手动设置Id属性的IsTemporary为true
• 核心需求：让EF Core自动忽略实体上预置的Id值，主键完全由数据库配置的IDENTITY列自动生成，无需修改现有客户端传值逻辑

复现代码 #

实体定义 #

public class TPTUser
{
    public int Id { get; set; }
    public string Username { get; set; }
    public string Email { get; set; }
}

public class TPTStudent : TPTUser
{
    public string CGPA { get; set; }
    public string Major { get; set; }
}

public class TPTTeacher : TPTUser
{
    public string Designation { get; set; }
    public string Speciality { get; set; }
}

DbContext原始配置 #

public class TestContext : DbContext
{
    public DbSet<TPTUser> TPTUsers { get; set; }
    public DbSet<TPTStudent> TPTStudents { get; set; }
    public DbSet<TPTTeacher> TPTTeachers { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer(@"Foo");
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<TPTUser>().ToTable("TPTUsers");
        modelBuilder.Entity<TPTUser>()
            .HasKey(p => p.Id);
        modelBuilder.Entity<TPTUser>()
            .Property(p => p.Id)
            .ValueGeneratedOnAdd()
            .UseIdentityColumn();

        modelBuilder.Entity<TPTStudent>().ToTable("TPTStudents");
        modelBuilder.Entity<TPTTeacher>().ToTable("TPTTeachers");
    }
}

插入测试逻辑 #

static void Main(string[] args)
{
    using (var context = new TestContext())
    {
        var std = new List<TPTStudent>
        {
            new TPTStudent()
            {
                Id = 422,
                Username = Guid.NewGuid().ToString("N"),
                Email = Guid.NewGuid().ToString("N"),
                CGPA = Guid.NewGuid().ToString("N"),
                Major = Guid.NewGuid().ToString("N")
            },
            new TPTStudent()
            {
                Id = 412,
                Username = Guid.NewGuid().ToString("N"),
                Email = Guid.NewGuid().ToString("N"),
                CGPA = Guid.NewGuid().ToString("N"),
                Major = Guid.NewGuid().ToString("N")
            }
        };

        context.TPTStudents.AddRange(std);
        context.SaveChanges();
    }
}

根因说明 #

EF Core 6的TPT映射存在特殊处理逻辑：即使基类主键已经配置了数据库自动生成，当派生类实体的主键被预先赋值为非默认值时，EF Core不会自动将其识别为需要覆盖的临时值，会直接生成显式插入主键的SQL语句，触发IDENTITY列插入报错。

适配EF Core 6的实现方案 #

通过重写DbContext的SaveChanges和SaveChangesAsync方法，在数据提交到数据库前，统一遍历所有处于新增状态的TPT继承体系实体，将预置的非默认主键值重置为int类型默认值0，EF Core就会自动识别该字段需要由数据库生成值，不会再生成显式插入主键的SQL。

public class TestContext : DbContext
{
    // 原有DbSet、OnConfiguring、OnModelCreating逻辑保持不变

    public override int SaveChanges()
    {
        ResetTPTEntityPresetId();
        return base.SaveChanges();
    }

    public override Task<int> SaveChangesAsync(CancellationToken cancellationToken = default)
    {
        ResetTPTEntityPresetId();
        return base.SaveChangesAsync(cancellationToken);
    }

    private void ResetTPTEntityPresetId()
    {
        var addedEntities = ChangeTracker.Entries<TPTUser>()
            .Where(entry => entry.State == EntityState.Added)
            .ToList();
        foreach (var entry in addedEntities)
        {
            // 重置主键为默认值，强制使用数据库IDENTITY生成值
            entry.Property(e => e.Id).CurrentValue = default;
        }
    }
}

方案说明：该实现不需要修改现有客户端传值逻辑，不需要手动开启数据库的IDENTITY_INSERT配置，也不需要调整已有的Fluent API实体配置，所有TPTUser派生类的新增实体都会自动忽略客户端传入的预置Id，插入完成后实体对象上的Id属性会自动被回填为数据库生成的最新值。如果不需要全局生效，也可以在单次调用SaveChanges前，手动对需要新增的实体执行相同的Id重置逻辑。

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