在使用Go语言的Mgo驱动操作MongoDB时，BSON.M是构建查询条件的核心结构，它本质上是一个map[string]interface{}类型，用来描述MongoDB的查询文档。当查询涉及嵌套文档或者动态组合条件时，正确构建嵌套的BSON.M结构是保证查询逻辑准确的关键。
BSON.M的基本特性
BSON.M是Mgo库中定义的类型，源码定义为type BSON_M map[string]interface{}，它对应MongoDB中的BSON文档。每一个键对应MongoDB文档的字段名，值对应查询条件或者字段值。由于它是map类型，所以支持动态添加键值对，非常适合构建动态查询。
需要注意的是，BSON.M的键名需要和MongoDB文档的字段名完全一致，包括嵌套字段的点分隔符，比如要查询user.name字段，键名就要写成user.name。
基础嵌套BSON.M的构建
单层级嵌套查询
如果要查询嵌套文档中的某个字段，比如文档结构是{ "user": { "name": "张三", "age": 20 } }，需要查询user.age大于18的文档，对应的BSON.M构建方式如下：
package main
import (
"gopkg.in/mgo.v2/bson"
)
func main() {
// 构建查询条件：user.age > 18
query := bson.M{
"user.age": bson.M{"$gt": 18},
}
// 后续将query传入Find方法即可
}
这里直接在键名中使用点分隔符来表示嵌套字段，值是另一个BSON.M用来存放比较操作符和条件值。
多层级嵌套查询
如果嵌套层级更多，比如文档结构是{ "user": { "info": { "address": { "city": "北京" } } } }，需要查询city为北京的文档，构建方式类似：
func buildMultiLevelQuery() bson.M {
// 构建查询条件：user.info.address.city = "北京"
query := bson.M{
"user.info.address.city": "北京",
}
return query
}
动态拼接嵌套BSON.M
实际开发中经常需要根据用户输入动态拼接查询条件，比如用户可选填user的年龄范围和所在城市，只有填写了对应条件才加入查询。这时候可以初始化一个空的BSON.M，然后动态添加键值对：
func buildDynamicQuery(minAge, maxAge int, city string) bson.M {
query := bson.M{}
// 动态添加年龄条件，如果有最小值则添加$gt条件
if minAge > 0 {
// 如果已经存在user.age的条件，需要合并
if ageCond, ok := query["user.age"]; ok {
// 原有条件转成bson.M后添加新的比较符
ageMap := ageCond.(bson.M)
ageMap["$gte"] = minAge
query["user.age"] = ageMap
} else {
query["user.age"] = bson.M{"$gte": minAge}
}
}
if maxAge > 0 {
if ageCond, ok := query["user.age"]; ok {
ageMap := ageCond.(bson.M)
ageMap["$lte"] = maxAge
query["user.age"] = ageMap
} else {
query["user.age"] = bson.M{"$lte": maxAge}
}
}
// 动态添加城市条件
if city != "" {
query["user.info.address.city"] = city
}
return query
}
这种动态拼接的方式可以灵活应对各种查询条件的组合，避免因为条件为空导致查询出错。
常见构建错误和解决方案
| 错误类型 | 错误示例 | 解决方案 |
|---|---|---|
| 嵌套结构使用多层BSON.M包裹 | bson.M{"user": bson.M{"age": bson.M{"$gt": 18}}} | 直接使用点分隔符的键名，改为bson.M{"user.age": bson.M{"$gt": 18}} |
| 键名和文档字段不匹配 | 文档字段是user_name，键名写成userName | 严格匹配MongoDB文档的字段名，包括大小写和下划线 |
| 动态拼接时类型断言错误 | 直接对query["user.age"]进行类型转换没有做ok判断 | 先判断键是否存在，再做类型断言，避免panic |
注意事项
- BSON.M的键值对是无序的，如果需要有序的文档可以使用bson.D，不过查询场景下BSON.M足够使用。
- 复杂嵌套查询如果需要使用数组相关操作符，比如
$elemMatch，同样可以在嵌套的BSON.M中添加对应键，比如bson.M{"user.hobbies": bson.M{"$elemMatch": bson.M{"name": "篮球"}}}。 - 动态构建查询时，如果多个条件对应同一个嵌套字段的不同操作符，记得合并到一个BSON.M中，不要重复设置同一个键，否则后面的会覆盖前面的条件。