PyMongo与MongoDB日期时间戳比较运算符查询返回空问题

查询返回空结果的核心原因是过滤条件中传入的时间值类型/时区与集合中存储的BSON日期格式不匹配，MongoDB不会对不同类型的值做隐式匹配，具体常见触发场景：

• 直接传入ISO格式的时间字符串作为ts字段的过滤值，字符串类型无法和BSON原生日期类型匹配，直接返回空。
• 传入了不带时区信息的naive datetime对象（即未指定tzinfo的datetime实例），和集合中存储的UTC标准时区BSON日期存在时区偏差，导致匹配失败。
• 时间范围查询时边界值写反、时间精度不匹配（如传入的时间带额外毫秒/微秒偏移，超出目标时间点）也会触发该问题，结合你已经通过find_one()拿到了正确的时间返回值，类型不匹配是最高概率的诱因。

构造查询条件时不要传字符串，统一使用带UTC时区信息的datetime对象作为过滤值，参考代码如下：

import pymongo
from pymongo import MongoClient
from datetime import datetime, timezone

# 初始化数据库连接
client = MongoClient("你的MongoDB连接地址")
db = client['sample_weatherdata']
collection = db['data']

# 错误写法1：传入时间字符串，类型不匹配
# res = list(collection.find({"ts": "1984-03-05T14:00:00.000+00:00"}))

# 错误写法2：传入无时区的datetime，时区不匹配
# res = list(collection.find({"ts": datetime(1984, 3, 5, 14, 0)}))

# 正确写法：构造带UTC时区的datetime对象作为查询条件
target_time = datetime(1984, 3, 5, 14, 0, tzinfo=timezone.utc)
res = list(collection.find({"ts": target_time}))
print(res)

如果需要做时间范围查询，同样要保证范围边界的datetime对象携带UTC时区信息，示例：

# 查询1984年3月5日全天的数据
start_time = datetime(1984, 3, 5, 0, 0, tzinfo=timezone.utc)
end_time = datetime(1984, 3, 6, 0, 0, tzinfo=timezone.utc)
range_res = list(collection.find({"ts": {"$gte": start_time, "$lt": end_time}}))

构造查询条件前可以先参考find_one()返回的ts字段值的类型，不要手动做时间格式转字符串的操作，避免类型不匹配。

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