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

admin 百科 2025-12-23 16

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

EF Core全局查询筛选器怎么用 EF Core Global Query Filters教程-第1张图片-佛山资讯网

EF Core全局查询筛选器（Global Query Filters）是一次配置、处处生效的自动过滤机制，不用每次写.Where(x => x.IsDeleted == false)或.Where(x => x.TenantId == current)，系统会在生成SQL时自动加上。

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

之后所有ctx.Articles.ToList()、ctx.Articles.First()等查询，SQL都会自动带WHERE IsDeleted = 0

如需查已被软删除的数据，用ctx.Articles.IgnoreQueryFilters().Where(a => a.IsDeleted)

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

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