如何基于取车与还车日期实现车辆可用性搜索

本文详解如何通过 SQL 子查询精准筛选在指定取车（pickup）与还车（return）日期区间内未被预订的车辆，修正原始查询中 JOIN 逻辑错误、GROUP BY 滥用及条件矛盾问题，并提供安全、可扩展的 CodeIgniter 实现方案。

本文详解如何通过 SQL 子查询精准筛选在指定取车（pickup）与还车（return）日期区间内**未被预订**的车辆，修正原始查询中 JOIN 逻辑错误、GROUP BY 滥用及条件矛盾问题，并提供安全、可扩展的 CodeIgniter 实现方案。

在租车系统中，“按日期搜索可用车辆”的核心逻辑并非查找已存在租约且时间重叠的记录，而是找出所有未被任何有效租约占用的车辆——即：该车辆的 carId 完全不出现于任何与搜索日期区间发生时间冲突的租约中。

原始代码存在多个关键缺陷：

• ❌ 错误使用 LEFT JOIN + WHERE rentCarId = NULL：先关联再过滤为空，实际会漏掉从未被租过的车辆（因 LEFT JOIN 生成 NULL 行），但更严重的是——它无法识别“当前有租约但时间不冲突”的车辆（如某车在下周被租，但用户搜的是明天，该车应可用）；
• ❌ WHERE rentEnd > $start AND rentStart < $end 写法错误：字符串 'rentEnd' > $start 是 PHP 字符串比较，非 SQL 字段比较；且该条件本身仅适用于“查找已租车辆”，而非“排除不可用车辆”；
• ❌ GROUP BY carName 与 SELECT *（含非聚合字段如 rentStatus, rentStart）冲突，违反 SQL 标准，数据库可能报错或返回不确定结果；
• ❌ LIKE 和日期条件混用在 WHERE 中未加括号，逻辑优先级易出错。

✅ 正确思路是：先找出所有在目标日期区间内“已被占用”的车辆 ID，再从 cars 表中排除它们。判断“占用”的标准是租约时间与搜索区间存在交集，即：

rentStart <= $end AND rentEnd >= $start

这覆盖所有重叠情形（租约开始前、中、后覆盖搜索期）。

以下是优化后的 CodeIgniter 模型方法（已防御 SQL 注入、语义清晰、支持空搜索）：

// model: M_cari.php
function search($car = null, $start = null, $end = null) {
    // 1. 构建基础车辆查询
    $this->db->select('carId as id, carName as name, carType as type, carPrice as price, carImage as image');
    $this->db->from('cars');

    // 2. 模糊匹配车名（若提供）
    if (!empty($car)) {
        $this->db->like('carName', $car);
    }

    // 3. 排除在 [$start, $end] 区间内已被占用的车辆（核心！）
    if (!empty($start) && !empty($end)) {
        $subquery = "(SELECT DISTINCT rentCarId FROM rent 
                      WHERE rentStart <= '" . $this->db->escape($end) . "' 
                        AND rentEnd >= '" . $this->db->escape($start) . "'
                        AND rentStatus = 'active')"; // 建议增加状态过滤，如 'confirmed', 'active'
        $this->db->where("carId NOT IN $subquery OR carId IS NULL");
    }

    return $this->db->get()->result_array();
}

⚠️ 重要注意事项：

• 日期格式必须统一：确保 $start/ $end 为 Y-m-d 格式（如 '2025-04-10'），且数据库 rentStart/rentEnd 字段为 DATE 或 DATETIME 类型；
• 租约状态过滤：生产环境务必添加 rentStatus 条件（如 AND rentStatus IN ('confirmed', 'active')），避免取消订单或待审核租约影响结果；
• 索引优化：为 rent(rentCarId, rentStart, rentEnd, rentStatus) 建立联合索引，大幅提升子查询性能；
• 边界处理：上述重叠条件 rentStart <= $end AND rentEnd >= $start 已正确处理“同日取还”“无缝衔接”等边界场景；
• 空值安全：OR carId IS NULL 防止子查询无结果时 NOT IN (NULL) 导致全表被排除（SQL 三值逻辑陷阱）。

控制器层保持简洁，仅做参数传递与视图渲染：

// controller
public function search() {
    $start = $this->input->post('start');
    $end   = $this->input->post('end');
    $car   = $this->input->post('car');

    // 基础校验（建议补充：日期有效性、start ≤ end）
    $data['cars'] = $this->M_cari->search($car, $start, $end);

    $this->template->title('车辆搜索结果');
    $this->template->build('car/v_search_index', $data);
}

总结：车辆可用性搜索的本质是集合补集运算——用子查询定义“不可用集合”，主查询取其补集。摒弃 JOIN 过滤幻觉，拥抱 NOT IN（或更优的 NOT EXISTS）语义，辅以严格日期重叠逻辑与生产级健壮性设计，即可交付准确、高效、可维护的搜索功能。