Laravel查询PostgreSQL时出现日期类型无效输入语法错误

在使用Laravel查询构建器从PostgreSQL获取记录时，遇到错误：Invalid datetime format: 7 ERROR: invalid input syntax for type date。

原代码如下：

AvailableReservationDatetime::query()
    ->select(DB::raw('
        available_date
        ,array_agg(available_time) available_times
    '))
    ->whereNotExists(function($query) {
        $query->select(DB::raw(1))
            ->from('reservations')
            ->where('reservation_date', 'available_date')
            ->whereBetween('available_time', ['reservation_time', 'end_time']);
    })
    ->groupBy('available_date')
    ->get();

错误出现在whereNotExists回调函数的where方法处，生成的中间SQL如下：

select available_date ,array_agg(available_time) available_times from "available_reservation_datetimes" where not exists (select 1 from "reservations" where "reservation_date" = available_date and "available_time" between reservation_time and end_time) group by "available_date"

该SQL直接在PostgreSQL中执行可成功获取记录，但Laravel中报错。通过显式类型转换后，查询可成功执行：

AvailableReservationDatetime::query()
    ->select(DB::raw('
        available_date
        ,array_agg(available_time) available_times
    '))
    ->whereNotExists(function($query) {
        $query->select(DB::raw(1))
            ->from('reservations')
            ->whereRaw('CAST(available_date AS DATE) = CAST(reservation_date AS DATE)')
            ->whereRaw('CAST(available_time AS TIME) BETWEEN CAST(reservation_time AS TIME) AND CAST(end_time AS TIME)');
    })
    ->groupBy('available_date')
    ->get();

1. Laravel查询构建器的where和whereBetween方法默认会把传入的非DB表达式参数当作字符串字面量处理，而非字段名引用。
   • 比如原代码中where('reservation_date', 'available_date')，Laravel会将'available_date'视为普通字符串值，而非available_reservation_datetimes表的字段名，最终生成的SQL逻辑实际是用reservation_date字段和字符串'available_date'做比较。
2. 当PostgreSQL尝试将字符串'available_date'转换为DATE类型时，因该字符串不符合日期格式规范，直接抛出invalid input syntax for type date错误。
3. 直接执行手动编写的SQL时，PostgreSQL会自动识别available_date为外部关联表的字段名，因此能正常执行字段间的比较。
4. 使用whereRaw方法时，Laravel不会对传入的SQL片段做参数绑定或字面量转换，而是直接将其嵌入最终SQL中，此时available_date会被正确识别为字段名；再加上显式的CAST类型转换，确保了字段间的类型匹配，查询即可正常执行。

内容的提问来源于stack exchange，提问作者youkichi