EF Core如何配置继承基类的实体关联表名自定义

我定义了如下基类：

public class Clearance
{
    public string Pre_Authorization_Number { get; private set; }
    public string Case_Reference_Number { get; private set; }
    public string Odo { get; private set; }
    public int Ltd { get; private set; }
    public string Merchant { get; private set; }
    public string Message { get; private set; }
    public decimal Total_Quote_Amount { get; private set; }
    public DateTime Date { get; private set; }
    public string Comment { get; private set; }
    public string Uploaded_By { get; private set; } //TODO Identity Manager
    public DateTime Date_Uploaded { get; private set; }
    public IList<ClearanceLineItem> ClearanceLineItems { get; private set; }
}

public class ClearanceLineItem
{
    public string Item_Number { get; private set; }
    public string Description { get; private set; }
    public float Qty { get; private set; }
    public decimal Avg { get; private set; }
    public decimal Amount { get; private set; }
}

并通过如下方式继承该基类：

public class VehicleClearance: Clearance
{
    public int Id { get; private set; }
    public int VehicleId { get; private set; }
    public string Clearance_Number { get; private set; }   
}

使用EF Core映射到数据库时，生成的表名为VehicleClearance和ClearanceLineItem。后续还有TurndownClearance、JobCardClearance等同类型子类，希望配置EF Core让关联表名自动生成为VehicleClearanceLineItems这类带子类前缀的名称。

可以通过EF Core的自定义实体配置或自定义模型约定实现，以下是两种可行方案：

方案1：逐个子类显式配置（简单可控） #

在DbContext的OnModelCreating方法中，为每个Clearance子类指定其关联的明细表名：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置VehicleClearance的关联明细表
    modelBuilder.Entity<VehicleClearance>()
        .HasMany(vc => vc.ClearanceLineItems)
        .WithOne() // 若ClearanceLineItem无需反向导航，保留此配置
        .ToTable("VehicleClearanceLineItems");

    // 新增TurndownClearance时同理
    modelBuilder.Entity<TurndownClearance>()
        .HasMany(tc => tc.ClearanceLineItems)
        .WithOne()
        .ToTable("TurndownClearanceLineItems");

    // JobCardClearance的配置
    modelBuilder.Entity<JobCardClearance>()
        .HasMany(jc => jc.ClearanceLineItems)
        .WithOne()
        .ToTable("JobCardClearanceLineItems");
}

这种方式适合子类数量较少的场景，表名配置精准可控。

方案2：自定义约定自动生成（批量处理） #

如果子类数量较多，可通过自定义EF Core模型约定实现自动命名，无需逐个配置：

步骤1：定义自定义约定类 #

public class ClearanceLineItemTableNamingConvention : IModelFinalizingConvention
{
    public void ProcessModelFinalizing(ModelFinalizingConventionContext context)
    {
        foreach (var entityType in context.Model.GetEntityTypes())
        {
            // 仅处理Clearance的子类
            if (entityType.ClrType.IsSubclassOf(typeof(Clearance)))
            {
                // 获取ClearanceLineItems导航属性
                var navigation = entityType.FindNavigation(nameof(Clearance.ClearanceLineItems));
                if (navigation != null)
                {
                    // 生成带子类前缀的表名：子类名称 + "LineItems"
                    var tableName = $"{entityType.ClrType.Name}LineItems";
                    // 设置关联明细表名
                    navigation.ForeignKey.PrincipalEntityType.SetTableName(tableName);
                }
            }
        }
    }
}

步骤2：注册自定义约定 #

在DbContext的OnConfiguring方法中替换默认约定：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseSqlServer("你的数据库连接字符串")
        .ReplaceService<IModelFinalizingConvention, ClearanceLineItemTableNamingConvention>();
}

此方案会自动为所有Clearance子类生成对应格式的明细表名，适合子类数量多的场景。

注意事项 #

• 若ClearanceLineItem需要保留与父类的关联，EF Core会自动生成外键字段，无需额外配置；
• 无论使用TPT（每个子类一张表）还是TPH（所有子类共用一张表）的继承策略，上述配置均生效；
• 自定义约定需EF Core 3.0及以上版本支持。

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