Laravel-MongoDB中whereBetween时间查询返回空结果问题

核心问题定位 #

查询返回空结果基本是以下三类原因导致，按优先级排查即可：

• 字段类型不匹配
  1. boat_id 查询传值类型和库内存储类型不一致：你代码里传的是字符串'3'，如果库中boat_id存储的是整型3，类型不匹配会直接导致筛选失效。
  2. 时间字段类型不匹配：tracking.timestamp如果在库中是整型时间戳（10位/13位Unix时间戳）、字符串格式时间，而非标准BSON日期类型，直接传入Carbon对象查询会因为类型无法比对返回空。
• 时间范围与时区偏差
  1. 结束时间设置错误：Carbon::createFromDate(2022,7,6)生成的是7月6日00:00:00的时间点，不是7月6日的结束时间，你当前的查询范围实际只覆盖到7月5日0点到7月6日0点，7月6日全天的数据都会被排除。
  2. 时区偏移：Jenssegers扩展会自动把Carbon对象转为UTC时区的BSON日期，如果库中存储的时间没有做UTC转换（比如直接存了东八区本地时间），查询范围会和实际存储时间差8小时，导致匹配不到数据。
• 扩展方法兼容问题
  部分低版本的Jenssegers/laravel-mongodb对whereBetween的日期类型自动转换存在bug，会出现Carbon对象没有正确转为BSON日期的情况。

修复步骤 #

1. 先在MongoDB Compass中执行原生查询，确认存在匹配数据，注意字段类型、时间类型和库内存储完全对齐：

// 原生查询参考，根据实际存储类型调整字段值
db.track_fishings.find({
  boat_id: 3, // 库中是字符串就改为"3"
  "tracking.timestamp": {
    $gte: ISODate("2022-07-05T00:00:00Z"),
    $lte: ISODate("2022-07-06T23:59:59Z")
  }
}).limit(1)

2. 替换Laravel查询代码，不要依赖whereBetween自动转换，手动指定比较规则，同时对齐类型和时间范围：

// 时间范围设置：结束时间设为7月7日0点，比卡7月6日23:59:59更稳妥，不会漏毫秒级数据
$start = Carbon::create(2022, 7, 5, 0, 0, 0, config('app.timezone'));
$end = Carbon::create(2022, 7, 7, 0, 0, 0, config('app.timezone'));

$tracks = TrackFishing::where('boat_id', 3) // 类型和库中对齐，存整型就传整型3，存字符串就传'3'
    ->where('tracking.timestamp', '>=', $start)
    ->where('tracking.timestamp', '<', $end)
    ->first();

3. 如果库中tracking.timestamp存的是整型Unix时间戳，把Carbon对象转为对应时间戳再查询：

$start = Carbon::create(2022, 7, 5)->timestamp; // 13位毫秒时间戳就 ->timestamp * 1000
$end = Carbon::create(2022, 7, 7)->timestamp;

$tracks = TrackFishing::where('boat_id', 3)
    ->where('tracking.timestamp', '>=', $start)
    ->where('tracking.timestamp', '<', $end)
    ->first();

快速排查技巧 #

如果调整后还是查不到，开启MongoDB连接的查询日志，打印实际执行的查询语句，和Compass中跑通的原生语句对比，就能快速定位参数、类型不一致的问题：

DB::connection('mongodb')->enableQueryLog();
// 执行你的查询逻辑
$tracks = TrackFishing::xxx->first();
// 打印实际生成的查询语句
dd(DB::connection('mongodb')->getQueryLog());

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