本文详解使用 mgo 驱动在 Go 中查询 MongoDB 嵌套文档（如 siteid.name）时常见失败原因，强调错误处理的必要性，并提供可落地的代码示例与最佳实践。
本文详解使用 mgo 驱动在 go 中查询 mongodb 嵌套文档（如 `siteid.name`）时常见失败原因，强调错误处理的必要性，并提供可落地的代码示例与最佳实践。
在使用 mgo 查询 MongoDB 中嵌套结构字段（例如 siteid.name）时，开发者常遇到“查询返回空切片但无报错”的现象——看似语法正确、RoboMongo 等 GUI 工具也能查出数据，Go 程序却始终得不到结果。根本原因往往并非查询逻辑错误，而是忽略了 mgo 方法调用的错误返回值。
mgo 的 Find().All() 等方法均返回 error，若未显式检查，底层连接异常、权限不足、字段类型不匹配或 BSON 解码失败等错误会被静默吞没，导致 videos 保持零值切片（[]Video{}），极易误判为“无数据”。
✅ 正确做法是：始终接收并校验 error。以下为推荐写法：
var videos []Video
err := collVideos.Find(bson.M{"siteid.name": profile.Name}).All(&videos)
if err != nil {
log.Printf("MongoDB query failed for site '%s': %v", profile.Name, err)
// 根据业务需要返回错误、跳过或 panic
return err
}
log.Printf("Found %d videos for site: %s", len(videos), profile.Name)
? 补充关键注意事项：
- 确保字段路径准确："siteid.name" 依赖 SiteProfile 在 Video 中以嵌入文档（embedded document）形式存储（而非 DBRef 或字符串 ID）。若 siteid 实际存为 ObjectId 字符串，需改用 bson.ObjectIdHex() 构造查询；
-
索引优化建议：对高频查询字段（如 siteid.name）建立复合索引可显著提升性能：
collVideos.EnsureIndexKey("siteid.name") - 结构体标签一致性：确认 SiteProfile 结构体字段名与 BSON 字段名严格匹配（如 Name → "name"），大小写敏感；
- mgo 已归档提醒：mgo 项目已停止维护（最后更新于 2019 年），生产环境建议迁移到官方驱动 mongo-go-driver，其错误处理更明确、上下文支持更完善。
总结：一次“空结果”排查，本质是一次对 Go 错误处理范式的再确认——永远不要忽略 error 返回值。严谨的错误检查不仅是调试利器，更是稳定服务的基石。
