本文详解如何在 golang 中使用 mongodb 官方驱动（mongo-go-driver）精确按 utc 日期范围（如“最近一天”）过滤文档，重点解决因时间精度、时区或字段名不匹配导致的查询结果为空问题。
本文详解如何在 golang 中使用 mongodb 官方驱动（mongo-go-driver）精确按 utc 日期范围（如“最近一天”）过滤文档，重点解决因时间精度、时区或字段名不匹配导致的查询结果为空问题。
在使用 mongo-go-driver 进行日期范围查询时，常见错误并非源于日期格式本身，而是由三个关键因素导致：字段名不一致、时间精度未对齐、时区处理不当。从问题描述可见，集合中实际存储的字段名为 "createdDate"（含大写 D），但代码中却使用了 "createdAt" —— 这是返回 0 条结果的最可能原因。
此外，原始代码中 time.Date(...) 构造的时间未考虑毫秒级精度，且 AddDate(0,0,-1) 仅减去 1 天，但未确保起始时间点为当日零点（UTC），易因本地时区或纳秒偏移造成边界遗漏。
✅ 正确做法如下（适配最新 go.mongodb.org/mongo-driver/bson 和 mongo）：
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
import (
"context"
"time"
"go.mongodb.org/mongo-driver/bson"
"go.mongodb.org/mongo-driver/mongo"
)
// 获取昨日零点（UTC）到今日零点（UTC）的时间范围
nowUTC := time.Now().UTC()
todayStart := time.Date(nowUTC.Year(), nowUTC.Month(), nowUTC.Day(), 0, 0, 0, 0, time.UTC)
yesterdayStart := todayStart.Add(-24 * time.Hour)
filter := bson.M{
"retailer": result.Id,
"createdDate": bson.M{ // 注意：字段名必须与数据库完全一致（此处为 "createdDate"）
"$gte": yesterdayStart,
"$lt": todayStart,
},
}
cursor, err := collectionRecords.Find(context.TODO(), filter)
if err != nil {
log.Fatal(err)
}
defer cursor.Close(context.TODO())
var collectionData []bson.M
if err = cursor.All(context.TODO(), &collectionData); err != nil {
log.Fatal(err)
}
count, err := collectionRecords.CountDocuments(context.TODO(), filter)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Found %d documents for yesterday (UTC)\n", count)
? 关键注意事项：
- 字段名严格匹配：MongoDB 字段名区分大小写，务必核对实际 schema（如 "createdDate" ≠ "createdAt"）；
- 统一使用 UTC 时间：所有时间操作应显式 .UTC()，避免本地时区干扰；
- 使用 CountDocuments() 替代已废弃的 Count()：新版驱动中 cursor.Count() 已移除，应调用集合的 CountDocuments 方法；
- 时间边界推荐 [$gte, $lt) 半开区间：避免同一天 23:59:59.999 被遗漏，也防止跨日重复计数；
- 验证时间字段类型：确保 createdDate 在数据库中确实是 BSON Date 类型（即 $date），而非字符串；若为字符串，需先用 $dateFromString 聚合转换，或修正写入逻辑。
? 提示：可通过 MongoDB Shell 执行 db.myCollection.findOne({retailer: ObjectId("...")}) 快速确认字段名与时间值的实际格式。坚持“字段名+UTC+半开区间”三原则，即可稳定实现任意粒度的日期范围查询。
