在Go语言使用mgo驱动操作MongoDB的场景中，bson.M是构建查询条件的核心结构，而日期范围查询是业务开发中非常常见的需求，掌握二者的正确结合方式能大幅提升查询逻辑的准确性和开发效率。
bson.M的基本使用规则
bson.M本质是map[string]interface{}的别名，用于定义MongoDB的BSON格式查询条件，其键值对对应MongoDB查询语句中的字段名和匹配规则。基础的等值查询可以直接通过键值对实现，比如查询用户名为test的用户：
package main
import (
"gopkg.in/mgo.v2"
"gopkg.in/mgo.v2/bson"
)
func main() {
session, err := mgo.Dial("127.0.0.1:27017")
if err != nil {
panic(err)
}
defer session.Close()
c := session.DB("test_db").C("user")
// 等值查询条件，查询name为test的文档
query := bson.M{"name": "test"}
var result map[string]interface{}
err = c.Find(query).One(&result)
}
如果需要使用MongoDB的查询操作符，比如大于、小于、存在判断等，需要在字段对应的值中使用嵌套的bson.M来定义操作符规则，例如查询年龄大于18的用户：
// 查询age大于18的文档
query := bson.M{
"age": bson.M{"$gt": 18},
}
日期范围查询的正确实践
日期范围查询通常需要结合$gte（大于等于）和$lt（小于）操作符，同时需要注意Go语言中time类型的处理，避免时区问题导致查询范围偏差。
基础日期范围查询示例
假设需要查询创建时间在2024年1月1日到2024年1月2日之间的文档，正确的构造方式如下：
package main
import (
"gopkg.in/mgo.v2"
"gopkg.in/mgo.v2/bson"
"time"
)
func main() {
session, err := mgo.Dial("127.0.0.1:27017")
if err != nil {
panic(err)
}
defer session.Close()
c := session.DB("test_db").C("order")
// 定义时间范围，注意使用UTC时间避免时区问题
startTime := time.Date(2024, 1, 1, 0, 0, 0, 0, time.UTC)
endTime := time.Date(2024, 1, 2, 0, 0, 0, 0, time.UTC)
// 构造日期范围查询条件
query := bson.M{
"create_time": bson.M{
"$gte": startTime,
"$lt": endTime,
},
}
var results []map[string]interface{}
err = c.Find(query).All(&results)
}
时区处理注意事项
MongoDB中存储的时间默认是UTC时间，如果Go代码中构造的时间带了时区偏移，会导致查询范围和预期不符。建议统一使用UTC时间构造查询条件，或者保证写入和查询时使用相同的时区设置。如果需要处理本地时间的转换，可以通过time.LoadLocation加载对应时区后构造时间：
// 加载上海时区
loc, _ := time.LoadLocation("Asia/Shanghai")
// 构造上海时区的2024年1月1日0点
startTime := time.Date(2024, 1, 1, 0, 0, 0, 0, loc)
// 转换为UTC时间后存入查询条件
query := bson.M{
"create_time": bson.M{
"$gte": startTime.UTC(),
},
}
常见使用误区
- 直接在bson.M的顶层使用操作符：比如写成
bson.M{"$gte": startTime}，这会导致查询条件无效，操作符必须作为字段值的嵌套bson.M的键。 - 日期范围端点混淆：使用
$gt和$lt还是$gte和$lte需要根据业务需求确定，比如查询某一天的数据通常用$gte当天0点和$lt第二天0点，避免包含第二天0点的数据。 - 忽略时间精度：如果业务中对时间精度要求高，构造时间时需要指定纳秒参数，避免默认0纳秒导致边界数据遗漏。
复合条件结合日期范围查询
实际业务中经常需要同时结合其他查询条件和日期范围，只需要在bson.M中增加对应的键值对即可，例如查询状态为1且创建时间在指定范围的订单：
query := bson.M{
"status": 1,
"create_time": bson.M{
"$gte": startTime,
"$lt": endTime,
},
}
这种写法会自动生成MongoDB的AND条件，所有条件需要同时满足才会匹配到对应文档。