EF Core TPT继承插入Cluster报错：无法将NULL插入Id列

我拥有一个SQL Server数据库，采用Table-per-type（TPT）继承模式，包含基类抽象表AbstractTable，以及两个派生表TableA和TableB：

表结构 #

• AbstractTable结构：

• TableA结构：

• TableB结构：

实体类与配置（EF Core 7.0.5 Fluent API） #

实体类 #

AbstractTable.cs：

public abstract class AbstractTable
{
    public int Id { get; set; }

    public string Name { get; set; } = null!;
}

TableA.cs：

public partial class TableA : AbstractTable{[..]}

TableB.cs：

public partial class TableB : AbstractTable{[..]}

配置类 #

AbstractTableConfiguration.cs：

public partial class AbstractTableConfiguration : IEntityTypeConfiguration<AbstractTable>
{
    public void Configure(EntityTypeBuilder<AbstractTable> entity)
    {
    }
}

TableAConfiguration.cs：

public partial class TableAConfiguration : IEntityTypeConfiguration<TableAConfiguration>
{
    public void Configure(EntityTypeBuilder<TableAConfiguration> entity)
    {
    }
}

TableBConfiguration.cs：

public partial class TableBConfiguration : IEntityTypeConfiguration<TableABConfiguration>
{
    public void Configure(EntityTypeBuilder<TableBConfiguration> entity)
    {

    }
}

问题现象 #

原本插入TableB数据时可成功执行：

context.TableB.Add(x)

但将TableB重命名为Cluster（含代码和数据库所有引用）后，插入数据时报错：

Cannot insert the value NULL into column 'Id', table 'test.dbo.Cluster'; column does not allow nulls. INSERT fails.

仅在Cluster的配置类中指定表名后才能正常工作：

public partial class ClusterConfiguration : IEntityTypeConfiguration<Cluster>
{
    public void Configure(EntityTypeBuilder<Cluster> entity)
    {
        entity.ToTable(nameof(Cluster));
    }
}

请问该如何解释这一行为？

这是EF Core在TPT继承模式下的表名约定冲突导致的问题，具体细节如下：

1. TPT模式的默认表名约定偏差
   在EF Core的TPT继承逻辑中，默认会以实体类名称匹配数据库表名，同时自动关联派生类与基类的主键配置（基类AbstractTable的Id为主键，且会自动生成值）。
   但重命名TableB为Cluster后，EF Core的约定识别系统出现了偏差——它误将Cluster识别为独立实体，而非AbstractTable的TPT派生类。此时EF Core不会复用基类的主键生成规则，插入时会尝试向Id列插入NULL，触发数据库的非空约束报错。

2. 显式指定表名的修正作用
   在ClusterConfiguration中调用entity.ToTable(nameof(Cluster))，相当于给EF Core明确传递了两个关键信息：

• 该实体对应数据库中的Cluster表
• 结合实体类继承AbstractTable的代码，EF Core能重新识别它是TPT模式下的派生类，进而复用基类的主键配置（自动生成Id值），解决空值插入问题。

3. 旧配置类的错误遗留影响
   你之前的TableBConfiguration存在泛型参数写错的错误（将TableB写成了TableABConfiguration），重命名为ClusterConfiguration时修正了这个问题，但如果没有显式指定表名，EF Core依然无法正确关联实体与数据库表，进一步加剧了约定识别的混乱。

内容的提问来源于stack exchange，提问作者S.Cari1