Laravel父子关联聚合查询技巧详解

本文深入解析了 Laravel Eloquent 中实现父子关联聚合查询（如 COUNT、SUM）的正确姿势，明确指出 with() 预加载机制因底层采用独立子查询而无法支持聚合函数，强行使用将导致报错或结果异常；文章系统阐述了以 leftJoin() + select() + addSelect() + groupBy() 为核心的替代方案，并区分了“包含无子父级”与“仅限有子父级”两类业务场景下的写法差异（如结合 whereHas 和 join），同时强调了索引优化、缓存策略及 groupBy 不可遗漏等易踩坑要点，为开发者提供兼具正确性、性能与可维护性的实战指南。

直接用 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 日志才能定位。

今天关于《Laravel父子关联聚合查询技巧详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！