EF Core全局查询筛选器怎么用 EF Core Global Query Filters教程

来源：这里教程网时间：2026-02-21 17:35:02 作者：

EF Core全局查询筛选器（Global Query Filters）是一次配置、处处生效的自动过滤机制，不用每次写

.Where(x => x.IsDeleted == false)

或

.Where(x => x.TenantId == current)

，系统会在生成SQL时自动加上。

软删除场景：自动过滤已标记删除的数据

适合需要保留历史记录、支持数据恢复的业务，比如文章、订单、用户资料等。

实体中加一个
bool IsDeleted
字段在
OnModelCreating
里配置：
modelBuilder.Entity().HasQueryFilter(a => !a.IsDeleted);

之后所有
ctx.Articles.ToList()
、
ctx.Articles.First()
等查询，SQL都会自动带
WHERE IsDeleted = 0
如需查已被软删除的数据，用
ctx.Articles.IgnoreQueryFilters().Where(a => a.IsDeleted)

多租户隔离：按租户ID自动过滤

每个租户看到的数据必须严格隔离，不能靠开发人员手动加条件，容易遗漏。

实体中添加
string TenantId
字段（建议非空、索引）在
DbContext
中注入
IHttpContextAccessor
，获取当前请求的租户标识（可来自JWT、Header、子域名等）配置过滤器：
modelBuilder.Entity().HasQueryFilter(p => p.TenantId == _tenantId);
其中
_tenantId
是
DbContext
构造函数注入并缓存的值注意为
TenantId
字段建立数据库索引，否则性能会明显下降

复合条件与导航属性联动

一个筛选器可以包含多个逻辑，还能跨关联实体生效。

例如同时满足软删除 + 状态启用：
p => !p.IsDeleted && p.IsActive 支持引用导航属性，比如只查“所属博客未被删除”的文章：
a => !a.Blog.IsDeleted && !a.IsDeleted 此时EF Core会自动把
Blog
上的过滤器也带上，形成递归过滤注意：同一实体只能有一个全局筛选器，多个
HasQueryFilter
调用会覆盖，要用
&&
合并条件

绕过筛选器的正确方式

某些管理后台或迁移脚本需要查看全部数据，包括被过滤掉的。

用
IgnoreQueryFilters()
临时关闭当前查询的全局过滤：
ctx.Users.IgnoreQueryFilters().ToList()
它只影响本次LINQ链，不影响后续其他查询 不要滥用——比如在普通API里用它查全部用户，可能造成越权访问 若需部分跳过（如只跳过租户过滤但保留软删除），目前EF Core不原生支持，得拆成两个DbContext或用原始SQL

基本上就这些。配置简单，效果直接，关键是能从框架层守住数据边界，避免人为疏漏。