EF Core ThenInclude用法及多级关联查询详解

ThenInclude 是 EF Core 中用于多级关联数据一次性加载的核心方法，必须接在 Include 后使用，支持集合→引用、集合→集合、引用→引用等路径延伸，同一层级多分支需重复 Include + ThenInclude。

EF Core 的 ThenInclude 是用来解决“多级关联数据一次性加载”问题的核心方法，它必须接在 Include 后面，不能单独使用。它的作用不是替代 Include，而是延伸加载路径——比如从“订单”到“订单项”，再从“订单项”到“商品”，这就是典型的两级延伸。

ThenInclude 必须配合 Include 使用

ThenInclude 没有独立意义，它只对上一个 Include 或 ThenInclude 返回的类型起作用。也就是说：

• Include(o => o.OrderItems) 返回的是 OrderItems 集合（ICollection）
• ThenInclude(oi => oi.Product) 的参数 oi 就是 OrderItem 类型，只能访问 OrderItem 的导航属性
• 不能跳过中间层，比如不能在 Order 上直接 ThenInclude 到 Product

支持集合和引用两种路径延伸

无论中间是集合还是单个引用，ThenInclude 都能继续往下走：

• 集合 → 元素的引用：如 Blog.Posts（集合）→ Post.Author（引用）
• 集合 → 元素的集合：如 Blog.Posts → Post.Comments（集合）
• 引用 → 下级引用：如 Post.Author → Author.ContactInfo

示例代码：

context.Blogs
  .Include(b => b.Posts)
  .ThenInclude(p => p.Author)
  .ThenInclude(a => a.Profile)
  .ToList();

同一层级多个分支要分开写 Include

如果想从同一个集合加载多个不同子属性（比如一篇文章既要作者，也要标签），不能靠一次 ThenInclude 完成，得重复写 Include + ThenInclude：

• 先写 .Include(b => b.Posts).ThenInclude(p => p.Author)
• 再写 .Include(b => b.Posts).ThenInclude(p => p.Tags)
• 两个调用都基于 Posts，EF Core 会合并成一条 SQL

避免常见错误

实际用错最多的地方集中在三类：

• 把 ThenInclude 放在最前面或中间断开链路（如漏了某个 Include）
• 参数表达式类型不匹配（比如 ThenInclude 里用了 Blog 的属性，但上一级是 Post）
• 过度加载导致结果集爆炸（比如博客有 100 篇文章，每篇有 50 条评论，查出来就是 5000 行，内存飙升）

建议搭配 Select 投影只取需要字段，或用分页控制数据量。

基本上就这些。用熟了你会发现，Include 和 ThenInclude 的链式结构，本质上就是在代码里画一棵查询树——根是主实体，枝杈是你明确指定的每一级关联。