正确做法是显式指定select字段且非聚合字段必须出现在groupBy中,如DB::table('orders')->select('user_id', DB::raw('COUNT(*) as count'))->groupBy('user_id')->get()。

如果您在 Laravel 应用中需要对查询结果按一个或多个字段归类统计,但发现直接调用 groupBy() 后报错、数据缺失或 SQL 报错(如 MySQL 5.7 严格模式下 SELECT 列不在 GROUP BY 中),则可能是由于分组语法不合规或聚合逻辑未显式声明。以下是 Laravel 中正确实现分组查询的多种方式:
一、基础单字段分组与聚合
适用于按单一列(如 category_id、status)分组并计算每组总数、最大值等。Laravel Query Builder 默认支持标准 SQL 分组行为,但必须确保所有非聚合列都出现在 GROUP BY 子句中。
1、使用 groupBy() 配合 select() 显式指定聚合字段:
2、调用 DB::raw() 包裹聚合函数(如 COUNT(*)、SUM(price))以避免字段歧义:
3、执行查询并获取结果,例如统计每个状态下的订单数量:
4、代码示例:
DB::table('orders')->select('status', DB::raw('COUNT(*) as count'))->groupBy('status')->get();
二、多字段联合分组
当需按多个维度组合划分数据(如按年份和月份统计销量),必须将全部分组字段依次传入 groupBy(),且所有 SELECT 中的非聚合列均须包含在内,否则在严格 SQL 模式下会失败。
1、使用数组形式传入多个字段名,确保顺序与 SELECT 中非聚合列一致:
2、配合 DB::raw() 提取日期部分(如 YEAR(created_at), MONTH(created_at))作为分组依据:
3、在 select 中明确写出这些提取字段,并在 groupBy 中重复列出:
4、示例:
DB::table('sales')->select(
DB::raw('YEAR(sold_at) as year'),
DB::raw('MONTH(sold_at) as month'),
DB::raw('SUM(amount) as total')
)->groupBy('year', 'month')->get();
三、使用 HAVING 过滤分组结果
HAVING 用于对已分组后的聚合结果施加条件限制,替代 WHERE 对原始行的筛选。例如只显示订单数超过 5 的用户,必须在分组后判断,不可用 WHERE。
1、先完成分组与聚合(如 COUNT(*)):
2、调用 having() 方法传入字段名、操作符与阈值:
3、支持链式调用多个 having 条件,如同时限制最小值与最大值:
4、示例:
DB::table('orders')->select('user_id', DB::raw('COUNT(*) as order_count'))
->groupBy('user_id')
->having('order_count', '>', 5)
->get();
四、结合子查询实现复杂分组逻辑
当主表分组需依赖关联表最新记录(如每个用户的最后一条消息)、或需跨表条件计数时,单纯 join + groupBy 易产生笛卡尔积或重复计数,此时应改用子查询嵌套。
1、在 select 中使用闭包定义子查询,例如统计每个用户未读消息数:
2、子查询内使用 where 条件绑定外层变量(如 user.id),并返回标量值:
3、主查询仍需正常 groupBy 关联字段,确保子查询被逐行执行:
4、示例:
DB::table('users')->select(
'users.id',
'users.name',
DB::raw('(SELECT COUNT(*) FROM messages WHERE messages.receiver_id = users.id AND messages.is_read = 0) as unread_count')
)->groupBy('users.id', 'users.name')->get();
五、规避 MySQL 严格模式报错的兼容写法
MySQL 5.7+ 默认启用 ONLY_FULL_GROUP_BY,若 select 列含非分组非聚合字段(如 SELECT id, name, COUNT(*) FROM t GROUP BY status),将直接拒绝执行。Laravel 中需主动适配。
1、禁用该 SQL 模式风险高,不推荐;应改为显式声明所有非聚合字段到 groupBy:
2、使用 DB::raw() 将非分组字段包裹进聚合函数(如 MIN(id), MAX(name)),仅当语义允许时采用:
3、改用 distinct() 替代 groupBy 实现去重目的(如只需唯一 email 列表):
4、示例(安全替代):
DB::table('users')->select('email')->distinct()->get();











