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

EF Core 全局查询筛选器是自动添加 WHERE 条件的机制，支持软删除（如！IsDeleted）、多租户隔离（如 TenantId 匹配）及复合条件（如！IsDeleted && IsActive），通过 HasQueryFilter 配置，IgnoreQueryFilters 可临时绕过。

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

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