LaravelEloquentGroupBy使用教程

本文深入解析了 Laravel Eloquent 在 MySQL 5.7+ 严格模式（only_full_group_by）下使用 GROUP BY 的核心陷阱与最佳实践：从必须显式声明聚合字段、避免混用非分组非聚合列，到正确处理关联查询、分页失效问题及复杂场景下的性能权衡，手把手教你写出安全、高效、可维护的分组查询代码——无论是统计订单总数、计算用户消费额，还是实现带用户名的分组结果分页，都能避开常见雷区，直达生产可用方案。

Group By后SELECT字段必须在GROUP BY中或用聚合函数包裹

直接写 DB::table('orders')->groupBy('user_id')->select('user_id', 'amount') 会报错，MySQL 5.7+ 默认启用 sql_mode=only_full_group_by，要求所有 SELECT 字段要么出现在 GROUP BY 子句里，要么被 MAX()、COUNT() 等聚合函数包裹。

正确做法是明确聚合意图：

• 查每个用户的订单总数：select('user_id', DB::raw('COUNT(*) as order_count'))
• 查每个用户的最大单笔金额：select('user_id', DB::raw('MAX(amount) as max_amount'))
• 若真要取某条原始记录（比如最新一条），不能靠 GROUP BY 直接“选”，得换思路——用子查询或窗口函数（Laravel 9+ 支持 over()）

Eloquent中用groupBy()必须配合select()显式声明字段

Eloquent 的 groupBy() 不会自动保留模型全部字段，不写 select() 就会默认 SELECT *，触发 SQL 错误或返回空结果。

常见错误写法：Order::groupBy('user_id')->get() —— 这实际生成的 SQL 在严格模式下非法。

安全写法示例：

Order::select('user_id', DB::raw('COUNT(*) as count'), DB::raw('SUM(total) as total_spent'))
    ->groupBy('user_id')
    ->get();

• 别在 select() 里混用未聚合的非分组字段（如 'created_at'），除非你加了 MIN(created_at) 或确认 MySQL 版本/模式允许
• 如果要用模型访问器或属性，聚合后得到的是普通集合（Illuminate\Support\Collection），不是模型实例，$item->getOriginal() 无效

分组后想关联查询？先聚合再join，别在groupBy前用with()

with('user') 放在 groupBy() 前，Eloquent 会尝试对每条原始记录预加载，但分组已把多行压成一行，关系数据会丢失或错乱。

正确路径是两步走：

• 第一步：聚合出分组结果（比如用户ID和统计值）
• 第二步：用这些 ID 查关联模型，再手动合并；或用 JOIN 显式关联（推荐）

例如查「每个用户的订单数 + 用户名」：

DB::table('orders')
    ->select('orders.user_id', 'users.name', DB::raw('COUNT(*) as order_count'))
    ->join('users', 'orders.user_id', '=', 'users.id')
    ->groupBy('orders.user_id', 'users.name')
    ->get();

注意：这里 GROUP BY 必须包含 users.name，否则又触发 only_full_group_by 报错。

Laravel 8+ 用cursorPaginate()分页分组结果会失效

cursorPaginate() 依赖上一页最后一条记录的字段值排序续读，但分组结果没有天然唯一、有序的游标字段（比如原始 id 已被折叠）。直接调用会抛出 BadMethodCallException 或返回重复/跳过数据。

替代方案：

• 用 paginate()（基于 OFFSET/LIMIT，适合中小数据量）
• 自己构造游标：比如用 MIN(user_id) 和 MAX(user_id) 分段，再查对应区间聚合结果
• 把分组结果存入临时表或缓存，再对临时表分页

真正容易被忽略的是：分组 + 分页 + 关联 + 排序这四个操作叠加时，SQL 复杂度指数上升，建议优先评估是否真需要实时计算——很多场景用定时任务预聚合到统计表更稳。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《LaravelEloquentGroupBy使用教程》文章吧，也可关注golang学习网公众号了解相关技术文章。