如何在Entity Framework Core中结合TPH使用自定义表前缀？

我在C#/WPF/EFC方面经验有限，当前开发WPF应用时使用Entity Framework Core存储数据，数据库为多应用共享实例，需要给本应用的表设置独立前缀。

核心需求 #

• 所有继承自抽象类Parent的子类，需存储在同一张表中
• 从表加载数据时能自动实例化对应的Child子类
• Parent本身不可实例化

当前实现代码 #

表前缀逻辑 #

在DbContext的OnModelCreating中添加了前缀设置：

foreach (var entity in modelBuilder.Model.GetEntityTypes())
{
    modelBuilder.Entity(entity.ClrType).ToTable(tablePrefix + entity.GetTableName());
}

TPH继承实现 #

public abstract class Parent
{
    // ... 属性定义
}

public class ChildA : Parent
{
    // ... 子类专属属性
}

public class ChildB : Parent
{
    // ... 子类专属属性
}

internal class EcroDbContext : DbContext
{
    private string tablePrefix = "APP_PREFIX_";

    public DbSet<Schedule> Schedules { get; set; } = null;

    public DbSet<ChildA> ChildA { get; set; } = null;
    public DbSet<ChildB> ChildB { get; set; } = null;

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        string user = "xxx";
        string password = "xxx";
        string dbName = "xxx";
        string conString = $"User Id={user};Password={password};Data Source={dbName}";

        optionsBuilder.UseOracle(conString, x => x.MigrationsHistoryTable(tablePrefix + "ef_migration_history", null));
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);

        modelBuilder.Entity<Parent>().ToTable(tablePrefix + "Jobs");

        // 删除此循环后TPH可正常工作
        foreach (var entity in modelBuilder.Model.GetEntityTypes())
        {
            modelBuilder.Entity(entity.ClrType).ToTable(tablePrefix + entity.GetTableName());
        }
    }
}

错误信息 #

执行Add-Migration InitialMigration时抛出错误：

Unable to create a 'DbContext' of type ''. The exception 'Both 'ChildB' and 'ChildA' are mapped to the table 'APP_PREFIX_APP_PREFIX_APP_PREFIX_Jobs'. All the entity types in a non-TPH hierarchy (one that doesn't have a discriminator) must be mapped to different tables.

问题根源是重复添加表前缀破坏了EF Core的TPH映射逻辑：

1. 你先手动给Parent设置了带前缀的表名APP_PREFIX_Jobs
2. 循环遍历所有实体时，Parent、ChildA、ChildB都会被重复处理：
   • Parent的表名已经是APP_PREFIX_Jobs，再次添加前缀后变成APP_PREFIX_APP_PREFIX_Jobs
   • ChildA/ChildB默认继承Parent的表名，处理后又会再加一次前缀，最终变成三次重复的前缀
3. 重复设置表名的操作会让EF Core无法识别这是TPH结构，反而判定为普通实体要求分表

修复方案一：过滤TPH层次实体 #

修改循环逻辑，跳过Parent及其子类（子类会自动继承父类的表映射）：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    // 配置TPH主表及鉴别器（显式配置鉴别器可选，EF Core会自动生成，但显式配置更可控）
    var parentEntity = modelBuilder.Entity<Parent>().ToTable(tablePrefix + "Jobs");
    parentEntity.HasDiscriminator<string>("JobType")
               .HasValue<ChildA>("ChildA")
               .HasValue<ChildB>("ChildB");

    // 仅给非TPH实体添加前缀
    foreach (var entity in modelBuilder.Model.GetEntityTypes())
    {
        if (typeof(Parent).IsAssignableFrom(entity.ClrType))
            continue;
        modelBuilder.Entity(entity.ClrType).ToTable(tablePrefix + entity.GetTableName());
    }
}

修复方案二：统一处理原始表名 #

使用EF Core提供的GetDefaultTableName()获取原始默认表名，避免基于已修改的表名重复添加前缀：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    foreach (var entity in modelBuilder.Model.GetEntityTypes())
    {
        // 获取EF Core默认生成的原始表名，而非已修改的表名
        var originalTableName = entity.GetDefaultTableName();
        modelBuilder.Entity(entity.ClrType).ToTable(tablePrefix + originalTableName);
    }

    // 可选：显式配置鉴别器
    modelBuilder.Entity<Parent>()
                .HasDiscriminator<string>("JobType")
                .HasValue<ChildA>("ChildA")
                .HasValue<ChildB>("ChildB");
}

关键注意事项 #

• TPH结构中，仅需给父类配置表名，所有子类会自动映射到同一张表，无需单独配置
• 处理表前缀时，必须避免对同一实体（或继承层次的实体）重复添加前缀
• 显式配置鉴别器可自主控制存储的鉴别值，避免EF Core自动生成的不可读标识

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