EF Core多实体映射同表并配置查询过滤器问题

问题原因 #

你遇到的错误是因为EF Core的TPH（Table-Per-Hierarchy）继承策略中，派生实体（如CustomerEntity、SupplierEntity）并非独立的根实体，查询过滤器只能应用于继承体系的根实体（即RegistryEntity），无法直接给派生实体添加独立过滤器。

可行实现方案 #

1. 实体类结构保持不变 #

保留你的继承层级，派生实体可按需添加专属属性：

public abstract class BaseEntity
{
    public int Id { get; set; }
    public DateTime CreatedAt { get; set; }
}

public class RegistryEntity : BaseEntity
{
    public string Name { get; set; }
    public bool IsCustomer { get; set; }
    public bool IsSupplier { get; set; }
    public string FullAddress { get; set; }
    // 其他全表字段
}

public class CustomerEntity : RegistryEntity
{
    // 可选：添加Customer专属属性
    // public string CustomerNumber { get; set; }
}

public class SupplierEntity : RegistryEntity
{
    // 可选：添加Supplier专属属性
    // public string SupplierCode { get; set; }
}

public class CorporationEntity
{
    public int Id { get; set; }
    public string Name { get; set; }
    // 仅保留需要的列
}

2. DbContext配置 #

核心配置要点：

• 仅将根实体RegistryEntity注册为DbSet
• 通过自定义IQueryable属性暴露过滤后的派生实体
• 将CorporationEntity配置为无键实体，映射到表的部分列

public class AppDbContext : DbContext
{
    // 仅注册根实体的DbSet
    public DbSet<RegistryEntity> Registries { get; set; }

    // 自定义属性，返回自动过滤的Customer/Supplier数据
    public IQueryable<CustomerEntity> Customers 
        => Registries.Where(r => r.IsCustomer).Cast<CustomerEntity>();
    
    public IQueryable<SupplierEntity> Suppliers 
        => Registries.Where(r => r.IsSupplier).Cast<SupplierEntity>();

    // 注册无键实体CorporationEntity
    public DbSet<CorporationEntity> Corporations { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置BaseEntity的主键
        modelBuilder.Entity<BaseEntity>()
            .HasKey(e => e.Id);

        // 配置RegistryEntity映射到registries表
        modelBuilder.Entity<RegistryEntity>()
            .ToTable("registries");

        // 配置派生实体的TPH继承关系
        modelBuilder.Entity<CustomerEntity>()
            .HasBaseType<RegistryEntity>();
        
        modelBuilder.Entity<SupplierEntity>()
            .HasBaseType<RegistryEntity>();

        // 配置CorporationEntity为无键实体，映射到registries表的指定列
        modelBuilder.Entity<CorporationEntity>()
            .HasNoKey()
            .ToTable("registries")
            .Property(c => c.Id).HasColumnName("Id")
            .Property(c => c.Name).HasColumnName("Name");
    }
}

3. 使用方式 #

在业务代码中直接通过自定义属性访问过滤后的实体：

// 获取所有客户
var customers = await dbContext.Customers.ToListAsync();

// 获取所有供应商
var suppliers = await dbContext.Suppliers.ToListAsync();

// 获取仅包含部分列的Corporation数据
var corporations = await dbContext.Corporations.ToListAsync();

4. 可选：限制根实体的直接访问 #

如果希望禁止直接通过Registries访问未过滤的数据，可以给RegistryEntity添加全局查询过滤器，强制所有根实体查询必须满足至少一个过滤条件：

modelBuilder.Entity<RegistryEntity>()
    .HasQueryFilter(r => r.IsCustomer || r.IsSupplier);

方案优势 #

• 严格遵循EF Core TPH继承规则，避免迁移报错
• 通过IQueryable链式调用实现过滤逻辑，灵活且符合EF Core设计思路
• 无键实体配置完美适配仅需部分列的CorporationEntity需求

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