Entity Framework全局查询过滤器未生效问题求助

问题场景 #

我为所有继承自EntityBase的实体配置了全局查询过滤器，用于过滤未被软删除的条目，配置代码如下：

// 过滤未被删除的条目
Expression<Func<EntityBase, bool>> filterExpr = eb => !eb.IsDeleted;
foreach (var mutableEntityType in modelBuilder.Model.GetEntityTypes())
{
    // 检查当前实体是否继承自EntityBase
    if (mutableEntityType.ClrType.IsAssignableTo(typeof(EntityBase)))
    {
        // 修改表达式以适配子类类型
        var parameter = Expression.Parameter(mutableEntityType.ClrType);
        var body = ReplacingExpressionVisitor.Replace(filterExpr.Parameters.First(), parameter, filterExpr.Body);
        var lambdaExpression = Expression.Lambda(body, parameter);

        // 设置查询过滤器
        mutableEntityType.SetQueryFilter(lambdaExpression);
    }
}

但调用categoryRepository.GetByIdAsync(id)时，依然能获取到已被软删除的Category实体，该仓库方法的实现代码如下：

public async Task<T?> GetByIdAsync(Guid id, 
    bool noTracking = false,
    params Expression<Func<T, object>>[] includeProperties)
{
    IQueryable<T> query = dbSet;

    if (noTracking) 
    {
        query = query.AsNoTracking();
    }

    if (includeProperties != null)
    {
        foreach (var includeProperty in includeProperties)
        {
            query = query.Include(includeProperty);
        }
    }

    return await query.FirstOrDefaultAsync(e =>
        EF.Property<Guid>(e, "Id") == id);
}

问题原因 #

问题出在GetByIdAsync中的查询条件写法：使用EF.Property<Guid>(e, "Id") == id这种动态属性访问方式，会导致EF Core无法将全局查询过滤器与该查询条件正确合并，最终忽略了过滤器的逻辑。全局过滤器是基于实体类型的强类型表达式，而动态属性访问破坏了EF Core的查询表达式匹配逻辑。

解决方案 #

方案一：强类型访问Id属性（推荐）

由于所有实体都继承自EntityBase，可以给仓库类添加泛型约束，确保T必须继承自EntityBase，然后直接通过强类型访问Id属性：

1. 修改仓库类的泛型约束：

public class Repository<T> where T : EntityBase
{
    // 现有仓库代码...
}

2. 修改GetByIdAsync的查询条件：

return await query.FirstOrDefaultAsync(e => e.Id == id);

方案二：确保表达式可被EF Core正确合并（备选）

如果无法添加泛型约束，或者实体的Id属性名称存在差异，可以调整全局过滤器的构建逻辑，使其与动态属性访问的查询条件兼容，但这种方式复杂度较高，不如强类型访问可靠。

额外检查点 #

• 确认Category实体确实继承自EntityBase，且IsDeleted属性已正确映射到数据库字段。
• 确认全局过滤器的配置代码在DbContext的OnModelCreating方法中正确执行，未被其他逻辑覆盖。

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