Laravel日期范围与关键词搜索组合技巧

本文详解如何在 Laravel 中正确实现关联模型的日期范围过滤与关键词搜索，避免因 SQL 运算符优先级导致的逻辑错误（如 WHERE date AND ... OR ... 错误匹配），并提供结构清晰、可维护的查询构建方案。

本文详解如何在 Laravel 中正确实现关联模型的日期范围过滤与关键词搜索，避免因 SQL 运算符优先级导致的逻辑错误（如 `WHERE date AND ... OR ...` 错误匹配），并提供结构清晰、可维护的查询构建方案。

在 Laravel 中对关联数据执行带日期范围的关键词搜索时，一个常见却极易被忽视的问题是：where() 与 orWhere() 的混合使用会破坏查询逻辑优先级，导致日期过滤失效。正如你在原始代码中所遇到的——即使指定的日期范围内无数据，只要某条记录满足任意一个 orWhere 条件，它仍会被返回。

根本原因在于生成的 SQL 中 AND 与 OR 缺乏分组，等价于：

WHERE (date(rekans.created_at) >= ? AND date(rekans.created_at) <= ? AND berat LIKE ?) 
   OR rekan_inv LIKE ? 
   OR suhu LIKE ? 
   -- ... 其余 OR 条件

这使得日期条件仅约束第一个 LIKE 子句，其余 OR 分支完全绕过时间筛选。

✅ 正确解法是：将所有搜索条件包裹在闭包中，用 where(...) 统一封装为一个逻辑组，确保整个搜索块与日期条件以 AND 关系组合：

$rekans = Rekan::query()
    ->join('dokters', 'dokters.id', '=', 'rekans.dokter_id')
    ->join('pasiens', 'pasiens.id', '=', 'rekans.pasien_id')
    ->join('penyakits', 'penyakits.id', '=', 'rekans.dokter_id') // ⚠️ 注意：此处疑似关联错误（应为 penyakits.id = rekans.penyakit_id？请按实际模型关系校验）
    ->join('treatments', 'treatments.id', '=', 'rekans.treatment_id');

// ✅ 日期范围：独立且明确的 AND 条件
if (request('from_date')) {
    $rekans->whereDate('rekans.created_at', '>=', request('from_date'));
}
if (request('to_date')) {
    $rekans->whereDate('rekans.created_at', '<=', request('to_date'));
}

// ✅ 搜索条件：统一包裹在 where() 闭包中，形成原子性逻辑组
if (request('search')) {
    $searchTerm = '%' . request('search') . '%';
    $rekans->where(function ($query) use ($searchTerm) {
        $query->where('rekans.berat', 'LIKE', $searchTerm)
              ->orWhere('rekans.rekan_inv', 'LIKE', $searchTerm)
              ->orWhere('rekans.suhu', 'LIKE', $searchTerm)
              ->orWhere('rekans.hasil_pemeriksaan', 'LIKE', $searchTerm)
              ->orWhere('rekans.anamnesa', 'LIKE', $searchTerm)
              ->orWhere('rekans.pengobatan', 'LIKE', $searchTerm)
              ->orWhere('rekans.kasus', 'LIKE', $searchTerm)
              ->orWhere('dokters.nama_dokter', 'LIKE', $searchTerm)
              ->orWhere('pasiens.nama', 'LIKE', $searchTerm)
              ->orWhere('penyakits.nama_penyakit', 'LIKE', $searchTerm)
              ->orWhere('treatments.nama_treatment', 'LIKE', $searchTerm);
    });
}

// 最终执行（建议添加分页与排序）
$results = $rekans->select('rekans.*', 'dokters.nama_dokter', 'pasiens.nama')
                  ->orderBy('rekans.created_at', 'desc')
                  ->paginate(15);

? 关键实践建议：

• 始终为多 OR 条件加 where(function () {}) 包裹，这是 Laravel 查询构造器的黄金准则；
• 显式限定字段前缀（如 'rekans.berat'），避免因 JOIN 表存在同名字段引发歧义或报错；
• 验证关联逻辑：你当前 penyakits.id = rekans.dokter_id 很可能有误（疾病通常不通过医生 ID 关联），请核对数据库设计与 Eloquent 关系定义；
• 安全增强：对 request('search') 做非空与长度校验，防止空字符串触发全表模糊扫描；
• 性能提示：在 rekans.created_at、常用于搜索的字段（如 rekan_inv）上建立复合索引可显著提升查询效率。

遵循以上写法，当日期范围（如 2022-04-13 至 2022-04-14）内无匹配数据时，查询将严格返回空集合，完全符合业务预期。