Laravel 按日期分组筛选预约记录方法

本文介绍在 Laravel 中使用 Eloquent 或查询构建器实现类似原生 SQL 的分组统计与条件筛选，即按日期对预约数据分组，并仅返回每组记录数大于等于指定阈值的结果。

在 Laravel 开发中，常需对数据库记录进行聚合统计（如按日期统计预约数量），并进一步筛选出“当日预约数 ≥ N”的结果。这对应 SQL 中的 GROUP BY + HAVING 组合逻辑。Laravel 提供了两种主流方式实现：Eloquent ORM 和 Query Builder，二者语法清晰、安全且支持链式调用。

✅ 推荐写法（使用 Query Builder）

use Illuminate\Support\Facades\DB;

$max = $request->input('min_reservations', 3); // 可从请求或数据库动态获取

$results = DB::table('reservations')
    ->selectRaw('COUNT(date) as numberofreservations, date')
    ->groupBy('date')
    ->havingRaw('COUNT(date) >= ?', [$max]) // ✅ 推荐使用参数绑定防注入
    ->orderBy('date')
    ->get();

⚠️ 注意：havingRaw('numberofreservations >= ' . $max) 存在 SQL 注入风险（若 $max 来源不可信）。应优先使用参数绑定形式 havingRaw('COUNT(date) >= ?', [$max])，既安全又兼容所有数据库驱动。

✅ Eloquent 写法（假设存在 Reservation 模型）

use App\Models\Reservation;

$max = config('app.min_daily_reservations', 2); // 或从数据库查出：$max = Setting::value('min_reservations');

$results = Reservation::selectRaw('COUNT(date) as numberofreservations, date')
    ->groupBy('date')
    ->havingRaw('COUNT(date) >= ?', [$max])
    ->orderBy('date')
    ->get();

? 调试技巧

开发阶段可快速验证生成的 SQL：

// 输出并终止执行，查看完整 SQL 语句及空结果原因
DB::table('reservations')
    ->selectRaw('COUNT(date) as numberofreservations, date')
    ->groupBy('date')
    ->havingRaw('COUNT(date) >= ?', [$max])
    ->dd(); // dump & die

若返回空集合 []，请检查：

• 表中 date 字段是否为 DATE/DATETIME 类型且有有效值；
• 是否存在满足 COUNT(date) >= $max 的日期分组；
• 数据库时区或日期格式是否导致分组异常（建议统一使用 DATE(date) 显式截取日期）。

? 进阶建议：提升可读性与复用性

可将逻辑封装为模型作用域（Scope）：

// In app/Models/Reservation.php
public function scopeWithMinDailyReservations(Builder $builder, int $min): Builder
{
    return $builder->selectRaw('COUNT(date) as numberofreservations, DATE(date) as date')
                    ->groupBy('DATE(date)')
                    ->havingRaw('COUNT(date) >= ?', [$min]);
}

// 使用
$results = Reservation::withMinDailyReservations($max)->get();

这样不仅增强代码可维护性，也便于在多个控制器中复用该统计逻辑。

总结：Laravel 完全支持 GROUP BY ... HAVING 场景，关键在于正确选用 selectRaw()、groupBy() 与 havingRaw()（配合参数绑定），并结合调试工具快速定位数据问题。