EF Core基于继承基类配置HasQueryFilter软删除报错求助

报错核心触发原因是EF Core的映射规则限制：实体继承层次的查询过滤器，仅允许配置在整个继承链的根实体上，不能为派生实体单独配置过滤器。
原批量配置逻辑遍历了所有符合条件的实体类型，没有过滤派生类，给非根实体（比如报错中的Group类型）也配置了过滤器，直接触发了该校验。
最初直接对DbEntity配置过滤器导致生成额外数据表，是因为手动调用modelBuilder.Entity<DbEntity>()会显式将该基类加入EF Core映射模型，EF Core默认会为模型中的可实例化类型生成对应表结构。

方案1：抽象基类直接配置（适合TPH单表继承场景） #

1. 将公共基类DbEntity标记为抽象类，EF Core不会为抽象基类生成独立数据表，同时基类上配置的过滤器会自动应用到所有派生实体：

public abstract class DbEntity
{
    public DateTime? DeletedDate { get; set; }
    // 其他公共属性
}

2. 在OnModelCreating中直接为基类配置软删除过滤器即可，不需要遍历所有派生类：

modelBuilder.Entity<DbEntity>().HasQueryFilter(c => c.DeletedDate == null);

注意：该方案默认使用TPH（单表继承）映射模式，所有派生实体会合并到同一张带鉴别器字段的表中，如果需要每个实体独立生成表，请使用方案2。

方案2：批量配置仅给根实体加过滤器（适配独立表、多层继承场景） #

如果项目存在多层实体继承，或者需要每个实体独立生成数据表、部分实体跳过软删除过滤，就修改批量配置逻辑，增加根实体判断，只给每个继承层次的根实体配置过滤器，通过表达式树直接构造过滤器，避免反射调用的复杂度：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    
    // 遍历所有已注册的实体类型
    foreach (var entityType in modelBuilder.Model.GetEntityTypes())
    {
        // 跳过不继承DbEntity的类型、跳过TaggableEntity派生类型、跳过非根实体
        if (!typeof(DbEntity).IsAssignableFrom(entityType.ClrType)
            || typeof(TaggableEntity).IsAssignableFrom(entityType.ClrType)
            || entityType.BaseType != null)
        {
            continue;
        }

        // 构造 x => x.DeletedDate == null 的过滤器表达式
        var param = Expression.Parameter(entityType.ClrType, "x");
        var filterExpr = Expression.Lambda(
            Expression.Equal(
                Expression.Property(param, nameof(DbEntity.DeletedDate)),
                Expression.Constant(null, typeof(DateTime?))
            ),
            param
        );
        entityType.SetQueryFilter(filterExpr);
    }
}

该方案不需要修改基类定义，也不会将基类额外加入映射模型，自动适配所有直接/间接继承DbEntity的根实体，过滤器会自动向下传递给所有派生类，不会触发非根实体配置过滤器的报错。配置完成后删除旧的异常迁移文件，重新生成迁移即可正常生成表结构，查询时会自动过滤DeletedDate不为null的软删除记录。

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