Eloquent 的 with() 不支持直接聚合,因其底层为独立子查询,不参与主查询 SELECT 构建;正确做法是用 leftJoin() + select() + addSelect() + groupBy() 实现 COUNT/SUM。

直接用 with() 加聚合函数会报错,因为 Eloquent 默认不支持在预加载中执行 count()、sum() 这类数据库聚合操作;必须改用 select() + addSelect() 配合 leftJoin() 手动关联并计算。
为什么不能在 with() 里直接 count() 子记录
Eloquent 的 with() 是懒加载或急加载机制,底层走的是独立子查询(N+1 或一次性批量 ID 查询),它不参与主查询的 SELECT 字段构建,因此无法嵌入 COUNT()、AVG() 等 SQL 聚合函数。你写 with(['children' => function ($q) { $q->selectRaw('COUNT(*) as total'); }]) 不会生效,甚至可能抛出 Column not found 错误。
Laravel 中对子表做 COUNT/SUM 的标准写法
核心是放弃 with(),改用 leftJoin() 关联子表,再用 select() 和 addSelect() 注入聚合字段:
-
leftJoin('children', 'parents.id', '=', 'children.parent_id'):确保一对多关系下父记录不被重复多次(需配合groupBy('parents.id')) -
select('parents.*'):显式选择父表字段,避免因*导致字段冲突 -
addSelect(DB::raw('COUNT(children.id) as children_count')):注入聚合字段,别名要小写加下划线,符合 Laravel 惯例 -
groupBy('parents.id'):必须加,否则 COUNT 会算总数而非每条父记录的子数
示例代码:
$parents = Parent::select('parents.*')
->leftJoin('children', 'parents.id', '=', 'children.parent_id')
->addSelect(DB::raw('COUNT(children.id) as children_count'))
->groupBy('parents.id')
->orderBy('parents.created_at', 'desc')
->get();
想查「有子记录的父级」且带子表 SUM,用 whereHas + join 组合
如果业务要求是「只返回至少有一个子项的父记录」,并且还要算子表某个字段的总和(比如订单总金额),就不能只靠 leftJoin —— 因为 leftJoin 会保留无子项的父记录(此时 SUM 为 NULL)。这时应:
- 先用
whereHas('children')过滤存在子记录的父级(语义清晰,可读性强) - 再用
join()替代leftJoin(),确保只连接有匹配的行 -
addSelect(DB::raw('SUM(children.amount) as total_amount')),同样要groupBy('parents.id')
注意:whereHas() 和 join() 可共存,前者过滤逻辑层,后者支撑聚合层,两者不冲突。
容易忽略的性能与兼容性点
聚合查询一旦涉及 JOIN 和 GROUP BY,就绕不开索引和 N+1 风险:
- 确保
children.parent_id有索引,否则JOIN会变全表扫描 - 不要在循环里执行这类聚合查询,它比普通
with()重得多;如需批量展示(如分页列表带子计数),优先考虑缓存children_count到父表字段 -
addSelect()在 Laravel 9+ 稳定,但低版本(如 8.x)若遇到字段丢失,可改用selectRaw()全写
最麻烦的不是写法,而是忘记 groupBy —— 它一漏,整个聚合结果就错成全局统计,而且 MySQL 8.0.22+ 默认 strict mode 下会直接报错,Laravel 日志里只显示 “SQLSTATE[42000]”,得翻 DB 日志才能定位。


















