EF Core TPC继承映射下关联配置报错的解决方法

错误原因 #

在TPC（每个具体类型一张表）映射策略下，ProformaInvoice继承自Invoice，其Customer导航属性从基类继承而来。当同时为Customer的Invoices和ProformaInvoices两个集合配置关联关系时，EF Core会判定这两个关系共享了同一个Invoice.Customer导航属性，违反「一个导航属性只能属于一个关系」的规则，因此抛出报错。

解决方案 #

需要显式为基类Invoice和派生类ProformaInvoice分别配置独立的关联关系，让EF Core明确区分两个关系对应的导航与反向集合。修改上下文的OnModelCreating方法如下：

public class MyContext : DbContext
{
    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);

        // 配置Customer实体
        var customerBuilder = builder.Entity<Customer>();
        customerBuilder.HasKey(x => x.Id);

        // 配置基类Invoice，启用TPC策略
        var invoiceBuilder = builder.Entity<Invoice>();
        invoiceBuilder.UseTpcMappingStrategy();
        invoiceBuilder.HasKey(x => x.Id);
        invoiceBuilder.Property(x => x.Value).IsRequired();
        // 显式关联Invoice与Customer，对应Customer.Invoices集合
        invoiceBuilder.HasOne(x => x.Customer)
            .WithMany(x => x.Invoices)
            .OnDelete(DeleteBehavior.Cascade);

        // 配置派生类ProformaInvoice
        var proformaInvoiceBuilder = builder.Entity<ProformaInvoice>();
        proformaInvoiceBuilder.Property(x => x.Notes).IsRequired();
        // 显式关联ProformaInvoice与Customer，对应Customer.ProformaInvoices集合
        proformaInvoiceBuilder.HasOne(x => x.Customer)
            .WithMany(x => x.ProformaInvoices)
            .OnDelete(DeleteBehavior.Cascade);
    }

    public DbSet<Customer> Customers => Set<Customer>();
    public DbSet<ProformaInvoice> ProformaInvoices => Set<ProformaInvoice>();
    public DbSet<Invoice> Invoices => Set<Invoice>();
}

关键修改说明 #

1. 移除原Customer配置中的两个HasMany调用，改为在Invoice和ProformaInvoice各自的配置中绑定对应的反向集合。
2. 为ProformaInvoice单独配置关联关系，明确指向Customer.ProformaInvoices集合，让EF Core识别这是独立于基类的关系。
3. TPC策略下，派生类会自动继承基类的属性映射，无需重复配置Value属性。

修改完成后，重新执行迁移命令即可正常生成迁移文件：

dotnet ef migrations add AddEntities

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