在MongoDB里做日期范围查询时，不少团队图省事把时间存成字符串，结果线上出现数据查不全的问题。根本原因在于MongoDB对字符串和Date类型的比较逻辑完全不同，而范围检索又高度依赖比较顺序与索引结构。只有理解底层机制，才能写出既正确又高效的查询语句。
一、字符串与Date类型的比较差异
MongoDB在比较字段大小时，会先按BSON类型编号排序，Date属于日期类型，字符串属于字符串类型，两者本身不会混用。但当我们用字符串存时间，又用字符串去做范围查询时，比较就退化成了字典序比较。字典序按字符逐个对比，例如"2023-12-01"与"2024-01-02"看起来正常，可一旦格式不统一，比如出现"2024-1-2"，就会因为短横后字符数不同而产生错误顺序。
相反，Date类型在MongoDB内部以64位毫秒数存储，比较时直接比数值。无论展示格式如何，底层都是时间线上的点。使用Date对象查询，不仅能保证顺序正确，还能命中日期字段上的B树索引，避免全集合扫描。下面用一段有问题的代码说明字符串陷阱：
// 错误示例：用字符串查询，可能因格式问题漏数据
const start = '2024-1-1';
const end = '2024-12-31';
db.orders.find({
createTime: { $gt: start, $lt: end }
});
// 若库中存有 '2024-01-05' 这类补零格式，字典序下 '2024-1-1' < '2024-01-05' 不成立，被漏掉
二、正确使用Date对象的范围查询
最佳实践是在写入和查询两端都使用Date类型。Node.js驱动会自动将JavaScript的Date转为BSON Date，Shell里则用ISODate()辅助函数。这样无论应用层传入什么格式，只要在查询前用new Date()或Date.parse()转成对象，比较就绝对可靠。
以下是在Node.js中按天查询订单的推荐写法，包含时区处理与索引提示：
// 正确示例：使用Date对象，并明确时区边界
const startDate = new Date('2024-01-01T00:00:00Z');
const endDate = new Date('2024-01-02T00:00:00Z');
const cursor = db.collection('orders').find({
createTime: {
$gte: startDate,
$lt: endDate
}
}).hint({ createTime: 1 }); // 强制走日期索引
// 返回当天全球统一时间内的订单，避免本地时区偏移
在MongoDB Shell中等价写法如下，注意ISODate生成的也是UTC时间：
// Shell正确写法
db.orders.find({
createTime: {
$gte: ISODate('2024-01-01T00:00:00Z'),
$lt: ISODate('2024-01-02T00:00:00Z')
}
})
三、索引与聚合中的日期查询要点
如果日期字段上没有索引，范围查询会退化为全表扫描，数据量越大越慢。应为常用查询字段建立单字段或复合索引，例如db.orders.createIndex({ createTime: 1 })。当查询同时包含用户ID与日期时，复合索引{ userId: 1, createTime: 1 }能进一步减少扫描量。
在聚合管道里做日期过滤，同样要坚持Date类型。可以利用$match阶段尽早过滤，再把结果交給$group。示例如下，统计某月每日订单量：
// 聚合中的日期范围过滤
db.orders.aggregate([
{
$match: {
createTime: {
$gte: new Date('2024-01-01T00:00:00Z'),
$lt: new Date('2024-02-01T00:00:00Z')
}
}
},
{
$group: {
_id: { $dateToString: { format: '%Y-%m-%d', date: '$createTime' } },
count: { $sum: 1 }
}
}
])
此外要留意时区表达。MongoDB存储的是UTC毫秒，展示时若用$dateToString不指定时区，默认也是UTC。国内业务常需东八区，应显式写timezone: 'Asia/Shanghai'，否则日报统计会偏移八小时，造成跨天数据错位。
四、常见误区与排查清单
误区之一是认为字符串YYYY-MM-DD一定安全。只要有人手动写入2024-1-1或通过Excel导入产生不一致格式，范围查询就会出错。误区之二是用$regex匹配日期前缀，这同样无法走索引且逻辑脆弱。排查时可用db.orders.find({ createTime: { $type: 'string' } })找出残留的字符串数据，统一迁移为Date。
总结来说，MongoDB日期范围查询的核心是：存储用Date、查询用Date、比较靠数值、索引保性能。避开字符串陷阱，系统的时间检索能力和稳定性都会明显提升。