子查询分组必须用fromSub()或joinSub()，不能直接塞Builder到select()；前者用于分组结果再聚合/分页，后者适合关联主表并支持on链式写法，二者自动处理括号、别名与参数绑定。
子查询分组必须用 fromSub() 或 joinSub()，不能直接塞 Builder 到 select()
直接在 select() 里传一个子查询 Builder 实例（比如 DB::table('orders')->where('user_id', 'users.id')->count()），Laravel 不会自动加括号、不绑定参数、不转义字段，结果要么查出空值，要么报错 SQLSTATE[HY000]: General error: 1305 FUNCTION xxx does not exist。根本原因是 Laravel 把它当普通字符串拼进 SQL，没当成子查询处理。
正确入口只有两个：fromSub()（把子查询当主表）和 joinSub()（把子查询当关联表）。它们会自动包裹括号、处理别名、安全绑定参数：
-
fromSub()适用于需要对分组结果分页、排序或再聚合的场景，例如「每个用户的最新订单」+paginate() -
joinSub()更适合关联已有主表，比如「用户 + 其订单数」，且能自然支持on()条件链式写法 - 别名参数必须提供，且不能是 MySQL 保留字（如
order、group、user）
whereHas() 不能替代分组子查询，该用 joinSub() 就别硬套
看到「查满足某聚合条件的主模型」，比如「至少有 3 条已审核评论的文章」，有人会想用 whereHas('comments', fn($q) => $q->where('is_approved', true)) 再 PHP 层 count，这是错的——whereHas() 只判断存在性，不统计数量；强行在闭包里加 limit(3) 或 count() 也不生效。
真正要基于聚合结果筛选，必须下推到数据库层：
- 用
joinSub()先算出每个文章的已审核评论数，再where('approved_count', '>=', 3) - 避免在
whereHas()闭包里写聚合函数（如count()），Eloquent 不识别，会当字段名处理 - 如果关联是多对多，注意中间表字段是否可直接在子查询中引用（Laravel 9+ 对中间表别名支持更稳）
分组字段不显式声明，MySQL 8.0+ 直接报错 SQLSTATE[42000]
Laravel 默认生成的 GROUP BY 查询在本地 MySQL 5.7 可能跑通，一上生产 MySQL 8.0+ 就崩，错误提示类似 Expression #1 of SELECT list is not in GROUP BY clause。这是因为 8.0+ 默认启用 ONLY_FULL_GROUP_BY 模式，要求所有 SELECT 中的非聚合字段必须出现在 GROUP BY 列表里。
解决方案不是关 SQL mode，而是写严实：
- 禁止
select('*')后跟groupBy()，哪怕只是测试 - 所有非聚合字段（如
user_id、status）必须显式列在groupBy()中 - 聚合字段务必加别名，如
DB::raw('COUNT(*) as order_count')，否则 Eloquent 映射不到属性 - 用
having()替代where()对聚合结果过滤，比如having('order_count', '>', 5)
大数据量下，groupBy() 后接 paginate() 会失效
数据库层面 GROUP BY 改变了原始行数，而 Laravel 的 paginate() 是按「未分组前的总记录数」去算页码的，导致翻页错乱、数据重复、总数不准。这不是 bug，是设计使然。
可行路径只有两条：
- 小数据（get() 拿全量 Collection，再用
collect()->forPage($page, $perPage)->sortByDesc('count') - 大数据：必须用子查询封装分组逻辑，再对子查询结果分页，即
fromSub($subQuery, 'stats')->paginate()，让数据库完成计数和切片 - 别在分组后直接链式调用
orderBy()再paginate()，Laravel 无法推导 COUNT(*) 的正确上下文
users.id 在外层 JOIN 时可能被解析成主表字段，也可能被当成子查询别名字段，取决于你用的是 joinSub() 还是手写 DB::raw() —— 前者自动处理别名隔离，后者得自己加前缀。 
