EF Core IncludeFilter怎么用 EF Core筛选性加载关联数据_技术教程

EF Core 5.0+ 支持通过 Include().Where() 实现关联集合的数据库端筛选，需配合 AsSplitQuery() 避免笛卡尔积；多级筛选可用 ThenInclude().Where()；更灵活场景推荐 Select 投影。

EF Core 本身没有内置的 IncludeFilter 方法，但自 EF Core 5.0 起，官方支持在 Include() 中结合 Where、OrderBy 等操作符实现**筛选性加载关联数据**（也称“过滤的包含”）。这个功能常被开发者误称为 IncludeFilter，实际是通过 Include().ThenInclude().Where() 链式表达式完成的。

用 Include + Where 实现关联数据筛选

默认 Include(b => b.Posts) 会加载博客下所有文章。如果只想加载「已发布」的文章，不能直接写 .Include(b => b.Posts.Where(p => p.IsPublished))（语法错误），而要使用 Include 的扩展方式：

对集合导航属性（如 List）：用 Include(...).Where(...) 形式
需引用 Microsoft.EntityFrameworkCore 命名空间
必须配合 AsSplitQuery() 或启用全局分割查询，否则可能触发笛卡尔积

示例：只加载辽宁省下「状态为启用」的市级数据

var provinces = context.Provinces
    .Where(p => p.Name == "辽宁省")
    .Include(p => p.Cities)
        .ThenInclude(c => c.Districts)
    .Include(p => p.Cities)
        .Where(c => c.Status == true) // ← 关键：筛选 Cities 集合
    .AsSplitQuery() // 推荐加上，避免结果膨胀
    .ToList();

多级筛选：ThenInclude 后接 Where

若需对更深层级做筛选（比如只加载某市下「2025 年新增」的区县），可在 ThenInclude 后继续加 Where：

只能用于集合导航属性（IEnumerable 类型），不能用于单个引用属性（如 Author）
筛选条件作用于数据库 SQL 的 ON 子句，不是内存过滤
生成的 SQL 会带 LEFT JOIN ... ON ... AND，确保主实体不因子数据不满足条件而丢失

示例：查博客，只包含「2025 年发布的文章」及其「点赞数 > 10 的评论」

var blogs = context.Blogs
    .Include(b => b.Posts)
        .ThenInclude(p => p.Comments)
            .Where(c => c.Likes > 10)
    .Include(b => b.Posts)
        .Where(p => p.PublishDate.Year == 2025)
    .AsSplitQuery()
    .ToList();

替代方案：用 Select 投影更精准控制

当 Include().Where() 不够灵活（比如要跨表条件、聚合或排序），推荐改用 Select 投影——它在数据库层完成筛选与字段裁剪，性能更好、语义更清晰：

返回的是匿名类型或 DTO，不是完整实体，不可直接修改跟踪
天然避免 N+1 和笛卡尔积问题
可自由组合主表和关联表字段，甚至加 Count、Max 等聚合

示例：只取博客名、文章标题和评论数（仅含已发布文章）

var blogSummary = context.Blogs
    .Select(b => new
    {
        BlogName = b.Name,
        Posts = b.Posts
            .Where(p => p.IsPublished)
            .Select(p => new
            {
                Title = p.Title,
                CommentCount = p.Comments.Count()
            })
    })
    .ToList();