本文详解 $gte 与 $lt（或 $lte）组合查询失败的核心原因：边界逻辑冲突、时间类型不匹配、字符串误比较及空结果判断误区，并提供可直接复用的修复方案与最佳实践。
本文详解 `$gte` 与 `$lt`（或 `$lte`）组合查询失败的核心原因：边界逻辑冲突、时间类型不匹配、字符串误比较及空结果判断误区，并提供可直接复用的修复方案与最佳实践。
在 MongoDB 中使用日期范围查询（如 {"createdOn": {"$gte": "2022-04-11T00:08:54Z", "$lt": "2022-04-11T00:08:54Z"}}）却返回空数组，是开发者高频踩坑场景。根本原因并非服务异常或连接失败，而是查询逻辑本身自相矛盾：一个时间值不可能同时满足“≥ X”且“
✅ 正确的时间范围写法：闭开区间（推荐）
为精确查询某一天（如 2022-04-11）的所有记录，应采用 左闭右开区间（[start, end)），避免边界歧义和时区漂移：
{
"createdOn": {
"$gte": "2022-04-11T00:00:00Z",
"$lt": "2022-04-12T00:00:00Z"
}
}
? 说明：$lt 的上限设为次日零点，确保包含 2022-04-11 全天（毫秒级）数据，且天然规避 23:59:59.999 手动截断误差。
⚠️ 关键陷阱与解决方案
| 问题类型 | 表现 | 诊断与修复 |
|---|---|---|
| 字符串 vs ISODate 类型 | "2022-04-11T00:08:54Z" 被当字符串比较 → "2022-04-11T00:08:54Z" | ✅ 确保数据库中 createdOn 字段为 ISODate 类型（用 db.collection.findOne().createdOn 检查类型）； ❌ 避免存为字符串（如 "2022-04-11T00:08:54Z"），否则 $gte/$lt 将执行字典序比较（"10" |
| 字段名不一致 | 文档中是 createdAt，查询却用 createdOn | 用 db.collection.findOne() 查看真实字段名，严格区分大小写与拼写（createdAt ≠ createdOn） |
| 时区隐式转换 | 前端传 2022-04-11 未带 Z，被解析为本地时区时间 | ✅ 统一使用 UTC 时间戳（末尾加 Z）； ✅ 后端接收后立即转为 new Date(value + 'Z') 再构造查询 |
? Python/PHP 中的安全实践示例（以 PHP cURL 为例）
// ✅ 正确：生成严格 UTC 时间范围（支持动态日期）
$startDate = (new DateTime('2022-04-11'))->setTime(0, 0, 0)->format('c'); // 2022-04-11T00:00:00+00:00
$endDate = (new DateTime('2022-04-12'))->setTime(0, 0, 0)->format('c'); // 2022-04-12T00:00:00+00:00
$payload = json_encode([
"dataSource" => $this->dataSource,
"database" => $this->database,
"collection" => $this->collection,
"filter" => [
"type" => ["\$eq" => $query],
"createdAt" => [ // 注意：此处字段名需与文档一致！
"\$gte" => $startDate,
"\$lt" => $endDate
]
]
]);
curl_setopt($curl, CURLOPT_POSTFIELDS, $payload);
? 空结果处理：别再误判 find() 游标！
- find() 永远返回游标对象（非 null 或空数组），if ($cursor) { ... } 恒为真 → ❌ 错误！
- ✅ 正确做法：
- 存在性判断：用 find_one()，检查返回是否为 null；
- 取首条+防崩：$doc = $collection->findOne($filter); if ($doc) { echo $doc['createdAt']; }；
- 默认值兜底（聚合）：在 $project 阶段用 {"$ifNull": ["$createdAt", {"$dateFromString": {" dateString": "1970-01-01" }}]}。
? 总结：四条铁律
- 逻辑先行：$gte + $lt 必须构成有效区间（start
- 类型唯一：日期字段必须为 ISODate，杜绝字符串存储；
- 字段精准：查询前 findOne() 确认字段名与值格式；
- 空值防御：用 find_one() 替代 find() 做存在判断，避免游标误判。
遵循以上原则，即可彻底告别“明明有数据却查不到”的困扰，让时间范围查询稳定、准确、可预期。
