mgo 默认将 Go 结构体的导出字段名转为小写作为 MongoDB 文档键名，导致查询失败；需通过 bson struct tag 显式指定字段名以保持大小写一致。
mgo 默认将 go 结构体的导出字段名转为小写作为 mongodb 文档键名，导致查询失败；需通过 `bson` struct tag 显式指定字段名以保持大小写一致。
在使用 mgo（v2）与 MongoDB 交互时，一个常见且易被忽视的问题是：结构体字段插入后在数据库中自动变为小写形式（如 Dimension_id → dimension_id），从而导致后续按原结构体字段名（驼峰或大驼峰）查询时无法匹配文档。
这是因为 mgo 底层依赖 gopkg.in/mgo.v2/bson 包进行序列化，其默认行为遵循 Go 的 JSON-like 规则：对每个导出字段，自动将首字母小写作为 BSON 键名（例如 Attribute → "attribute"），且会将下划线分隔符后的字母也一并小写（如 Frequency_count → "frequency_count"）。这一行为由 bson.Marshal 实现，并非 bug，而是设计约定。
以下是一个典型问题复现示例：
type Record struct {
Dimension_id int
Attribute string
Hour string
Frequency_count int
}
doc := Record{2, "good", "20160712_06", 100}
err := c.Insert(&doc) // 实际插入: {"dimension_id":2,"attribute":"good","hour":"20160712_06","frequency_count":100}
此时若用原始字段名查询：
c.Find(bson.M{"Dimension_id": 2}).One(&result) // ❌ 找不到 —— DB 中键名为 "dimension_id"
必须改为小写键名才能命中：
c.Find(bson.M{"dimension_id": 2}).One(&result) // ✅ 成功
✅ 正确解决方案：使用 bson struct tag 显式声明字段映射关系：
type Record struct {
Dimension_id int `bson:"Dimension_id"`
Attribute string `bson:"Attribute"`
Hour string `bson:"Hour"`
Frequency_count int `bson:"Frequency_count"`
}
添加 tag 后，mgo 将严格按指定字符串生成 BSON 键名，插入结果为：
{ "_id": ..., "Dimension_id": 2, "Attribute": "good", "Hour": "20160712_06", "Frequency_count": 100 }
此时查询可直接使用原始字段名，语义清晰且与结构体定义一致：
c.Find(bson.M{"Dimension_id": 2, "Attribute": "good"}).One(&result) // ✅ 完全匹配
⚠️ 注意事项：
- bson tag 值支持额外选项，如 ,omitempty（空值不序列化）、,string（数值转字符串存储）等；
- 若字段名含特殊字符或需兼容旧数据，tag 是唯一可控方式；
- mgo 已停止维护（官方推荐迁移到 mongo-go-driver），新项目建议优先选用官方驱动，其 bson tag 行为更标准化且文档完善；
- 避免混合使用无 tag 字段与带 tag 字段——未加 tag 的字段仍会走默认小写逻辑，易引发不一致。
总结：不要依赖默认小写行为，尤其当字段命名需与外部系统（如 REST API、遗留 schema）对齐时，始终显式声明 bson:"FieldName" 是健壮、可维护的最佳实践。
