如何在 Laravel 中按日期分组统计预约数量并筛选超过指定阈值的记录

本文详解如何使用 laravel 的 eloquent 和 query builder 实现 sql 中的 group by + having 逻辑，动态筛选每日预约数超过阈值（如 $max）的日期及对应计数，并提供调试技巧与安全注意事项。

在 laravel 开发中，将原生 SQL 的 GROUP BY … HAVING 逻辑迁移到 ORM 或查询构建器时，关键在于正确组合聚合函数、分组和条件过滤。以下是以“统计每日预约数并仅返回数量 ≥ $max 的日期”为例的完整实现方案。

✅ 推荐写法：使用参数绑定避免 SQL 注入（强烈建议）

// 控制器中（例如 ReservationController.php） $max = (int) $request->input('min_count', 2); // 从请求或数据库获取，强制转为整型  $reservationsByDate = Reservation::selectRaw('COUNT(date) as numberofreservations, date')     ->groupBy('date')     ->having('numberofreservations', '>=', $max) // ✅ 安全：使用参数绑定     ->orderBy('date')     ->get();

或使用 Query Builder（适用于无对应 Model 的场景）：

use IlluminateSupportFacadesDB;  $reservationsByDate = DB::table('reservations')     ->selectRaw('COUNT(date) as numberofreservations, date')     ->groupBy('date')     ->having('numberofreservations', '>=', $max)     ->orderBy('date')     ->get();

⚠️ 注意：切勿拼接变量到原始 SQL 字符串中（如 havingRaw(‘numberofreservations >= ‘ . $max)），这存在 SQL 注入风险。Laravel 的 having() 方法自动处理参数绑定，更安全、更可靠。

? 调试技巧：查看生成的 SQL 与结果

开发阶段可快速验证查询逻辑是否正确：

// 查看生成的 SQL 语句（不执行） DB::table('reservations')     ->selectRaw('COUNT(date) as numberofreservations, date')     ->groupBy('date')     ->having('numberofreservations', '>=', $max)     ->toSql(); // 返回字符串："select count(date) as numberofreservations, date from `reservations` group by `date` having `numberofreservations` >= ?"  // 查看实际执行结果（含 SQL 日志） DB::enableQueryLog(); $reservationsByDate = Reservation::selectRaw('COUNT(date) as numberofreservations, date')     ->groupBy('date')     ->having('numberofreservations', '>=', $max)     ->get();  // 输出最近一条查询（需开启日志） dd(DB::getQueryLog());

? 返回数据结构示例

假设数据库中有如下记录： | id | date | |—-|————| | 1 | 2024-05-01 | | 2 | 2024-05-01 | | 3 | 2024-05-02 |

当 $max = 2 时，结果为：

[   {     "numberofreservations": 2,     "date": "2024-05-01"   } ]

? 进阶提示

• 若 date 字段含时间（如 DATETIME 类型），需先截取日期部分：

  ->selectRaw('COUNT(*) as numberofreservations, DATE(date) as date') ->groupBy(DB::raw('DATE(date)'))

• 如需关联其他表（如用户信息），可在 selectRaw 中添加字段，并确保 groupBy 包含所有非聚合字段。
• 性能优化：为 date 字段添加数据库索引，显著提升分组查询速度。

掌握 selectRaw + groupBy + having 的组合用法，是 Laravel 中处理聚合统计类需求的核心技能。始终优先使用带参数绑定的方法，兼顾功能正确性与应用安全性。