如何使用Laravel进行一对多关联的复杂聚合查询？

本文共计847个文字，预计阅读时间需要4分钟。

直接使用 `withCount()` 或 `withSum()` 函数，无需手动编写子查询或循环系统计——这是最安全、最高效、也最符合 Eloquent 设计意图的做法。

什么时候必须用 withCount() 而不是 $user->posts->count()

当你需要在「一次查询」中获取多个用户的关联数量时，$user->posts->count() 会触发 N+1：先查出所有用户，再为每个用户单独执行 SELECT COUNT(*) FROM posts WHERE user_id = ?。100 个用户就是 100 次 COUNT 查询。

• withCount('posts') 底层生成一条带 LEFT JOIN 和 GROUP BY 的 SQL，只发一次请求
• 返回结果中自动添加 posts_count 属性，类型是整数，可直接用于 Blade 渲染或 API 响应
• 支持条件计数：比如只统计已发布的文章，用 withCount(['posts as published_posts' => function ($q) { $q->where('status', 'published'); }])
• 如果模型里定义了访问器（如 getPostsCountAttribute），它不会被覆盖，withCount() 生成的是独立字段

withSum() 和 withAvg() 的字段限制与 NULL 处理

withSum('posts', 'amount') 会生成 SUM(posts.amount)，但要注意两点：数据库字段本身为 NULL 时，SUM() 返回 NULL，不是 0；若该用户没有任何 posts 记录，结果也是 NULL。

• 避免前端报错：在控制器或资源类中统一处理，例如 $user->posts_sum_amount ?? 0
• 不能对非数值字段调用 withSum()，否则 MySQL 报错 Invalid use of group function
• withAvg() 同理，且当无记录时也返回 NULL，不自动转为 0.0
• 若需同时聚合多个字段（如 sum + count），Eloquent 允许链式调用：withCount('posts')->withSum('posts', 'amount')，仍是一条 SQL

多条件聚合时，on 子句和 where 子句的区别

当你用 withCount(['posts' => function ($q) { ... }])，闭包里的条件默认加在 ON 子句里（Laravel 8+ 默认行为）。这很关键：如果误把软删除判断写成 where('posts.deleted_at', null)，会导致没文章的用户被整个排除（LEFT JOIN 变成 INNER JOIN）。

• 正确写法是 whereNull('posts.deleted_at')，它会被 Laravel 自动放进 ON 条件，保留主表记录
• 如果真要过滤主表（比如只查 active 用户），必须写在主查询里：User::where('status', 'active')->withCount(...)->get()
• 不要在闭包里用 orWhere，容易破坏 ON 逻辑，改用 where() 链式组合
• 复合条件建议拆开：先用 withCount() 获取总数，再用 with(['posts' => fn($q) => $q->where(...)]) 加载具体数据，职责分离更清晰

真正容易被忽略的是聚合字段的命名冲突：如果你在模型里定义了 posts_count 访问器，又调用了 withCount('posts')，Eloquent 会优先使用数据库查出的值，访问器不会执行——这点在调试时经常让人困惑。