Laravel 查询中处理可空结束日期的动态范围筛选-php教程-PHP中文网

Laravel 查询中处理可空结束日期的动态范围筛选

本文讲解如何在 Laravel 中正确构建查询条件，使记录满足“大于等于开始时间、且仅当结束时间存在时小于等于结束时间”的逻辑，避免因 end_at 为 NULL 导致查询失效。

本文讲解如何在 laravel 中正确构建查询条件，使记录满足“大于等于开始时间、且仅当结束时间存在时小于等于结束时间”的逻辑，避免因 `end_at` 为 null 导致查询失效。

在实际业务中，常遇到类似 start_at（必填）与 end_at（可空）共存的时间范围字段。例如活动、价格策略或权限有效期等场景：若 end_at 为空，表示长期有效；若非空，则需严格落在 [start_at, end_at] 闭区间内。此时直接使用 whereBetween() 或固定双条件 where(...)->where(...) 均不可行——前者要求两端非空，后者会因 NULL >= $effectiveDate 恒为 false 而漏掉无截止日期的有效记录。

正确的做法是使用 条件化查询（Conditional Clauses），结合 whereNull() 与 whereNotNull() 分支逻辑：

$effectiveDate = '2022-04-06 23:34:00';

GroupExtras::query()
    ->select('group_extras.*')
    ->join('groups', 'group_extras.group_id', '=', 'groups.id')
    ->where('group_extras.start_at', 'where(function ($query) use ($effectiveDate) {
        // 分支一：end_at 为 NULL → 视为无限期，无需额外限制
        $query->whereNull('group_extras.end_at')
              // 分支二：end_at 非 NULL → 必须 >= effectiveDate
              ->orWhere(function ($sub) use ($effectiveDate) {
                  $sub->whereNotNull('group_extras.end_at')
                      ->where('group_extras.end_at', '>=', $effectiveDate);
              });
    })
    ->orderBy('group_extras.value')
    ->first();

✅ 关键点说明：

laravel-specialist

精通 Laravel 10+，遵循现代 PHP 实践的 Laravel 专家。擅长优雅语法、Eloquent ORM、队列系统及企业级特性...

下载

主条件 start_at
匿名闭包内使用 whereNull() 和 orWhere(...) 实现“或”逻辑：只要满足「无结束时间」或「有结束时间且未过期」任一条件即保留；
避免在 where() 中直接比较 NULL（如 end_at >= ?），因为 SQL 中 NULL >= value 返回 UNKNOWN，导致该行被排除。

⚠️ 注意事项：

不要误用 whereBetween('column', [$start, $end])：它底层生成 column BETWEEN $start AND $end，当 $end 为 null 时语句非法或恒假；
若需兼容 MySQL 5.7+ 严格模式，建议显式使用 DB::raw() 或 Carbon 格式化时间，确保 $effectiveDate 是标准 Y-m-d H:i:s 字符串；
对于大数据量表，应在 start_at 和 end_at 上建立联合索引（如 INDEX(start_at, end_at)）以提升查询性能。

此方案兼顾语义清晰性与数据库兼容性，是 Laravel 中处理“半开放时间区间”的推荐实践。