MongoDB Atlas API按datetime字段过滤返回0条文档问题排查

核心成因 #

• 类型不匹配是该问题的最常见诱因：请求载荷中filter条件内的DATE1字段传入的是字符串类型的时间值"2022-06-02T00:00:00Z"，但集合内存储的DATE1字段为BSON Date（ISODate）类型。MongoDB的等值匹配严格校验字段类型，字符串与日期类型不会触发隐式转换匹配，因此返回结果为空。
• 次要排查项：若修正类型后仍无返回，需确认集合内确实存在DATE1字段值为对应UTC时间的文档；若字段存储的时间带有时分秒毫秒偏移，精确匹配整0点时间也会出现结果为空的情况。

修复方案 #

MongoDB Data API 不支持直接传字符串匹配BSON日期类型，需要使用扩展JSON的$date操作符显式声明日期类型，修正后的请求载荷如下：

{
    "collection": "trade",
    "database": "sm",
    "dataSource": "Cluster0",
    "filter": {
        "DATE1": {
            "$date": "2022-06-02T00:00:00Z"
        }
    },    
    "sort": {
        "SYMBOL": -1
    },
    "projection": {
        "DATE1": 1,
        "SYMBOL": 1,
        "AVG_PRICE": 1
    }
}

如果业务场景是查询某自然日的全量数据（多数场景下日期字段会带具体时分秒、毫秒值，精确匹配整0点的文档极少），建议改用范围查询逻辑，参考filter片段：

"filter": {
    "DATE1": {
        "$gte": {"$date": "2022-06-02T00:00:00Z"},
        "$lt": {"$date": "2022-06-03T00:00:00Z"}
    }
}

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