使用 mgo 查询 MongoDB 时，若 Find() 仅返回单个文档而非全部匹配项，通常并非迭代逻辑错误，而是结构体字段的 BSON 标签缺失导致查询条件未正确映射到数据库字段。
使用 mgo 查询 mongodb 时，若 `find()` 仅返回单个文档而非全部匹配项，通常并非迭代逻辑错误，而是结构体字段的 bson 标签缺失导致查询条件未正确映射到数据库字段。
在 Go 中使用 mgo（现已归档，但仍在维护项目中广泛使用）进行 MongoDB 查询时，Find() 方法本身会返回所有匹配文档，关键在于后续如何遍历结果。从你提供的完整函数来看，迭代逻辑本身是正确的：
func (service *BlogEntryService) GetEntryByUserId(id string) []models.BlogEntry {
var entries []models.BlogEntry
iter := service.Collection.Find(bson.M{"user_id": bson.ObjectIdHex(id)}).Iter()
result := models.BlogEntry{}
for iter.Next(&result) {
entries = append(entries, result)
}
return entries
}该代码使用 iter.Next(&result) 循环读取所有匹配文档，理论上应返回全部结果。问题根源并非此处逻辑缺陷，而是 BlogEntry 结构体中 UserId 字段缺少 BSON 标签。
? 问题本质：BSON 映射失效
MongoDB 驱动（mgo）通过结构体的 bson tag 将 Go 字段与数据库字段名关联。你原始定义为：
type BlogEntry struct {
Id bson.ObjectId `bson:"_id,omitempty" json:"id"`
UserId bson.ObjectId `json:"user_id"` // ❌ 缺少 bson:"user_id"
Title string `json:"title"`
}虽然 json:"user_id" 用于 JSON 序列化，但 mgo 完全忽略 json tag，只依赖 bson tag 进行数据库读写映射。由于 UserId 字段无 bson:"user_id"，mgo 在反序列化文档时无法将数据库中的 "user_id" 字段值赋给 UserId 字段——但这不影响查询本身；真正影响的是：当你执行 .Find(...) 时，驱动仍能正常匹配文档，但后续 .Iter() 的反序列化过程可能因结构体字段映射异常导致行为不可靠（如静默跳过、零值填充或迭代提前终止）。实践中，这种缺失常引发难以复现的“只返回首条”现象，尤其在字段类型不匹配或存在嵌套时。
立即学习“go语言免费学习笔记（深入）”；
✅ 正确写法必须显式声明 BSON 标签：
type BlogEntry struct {
Id bson.ObjectId `bson:"_id,omitempty" json:"id"`
UserId bson.ObjectId `bson:"user_id" json:"user_id"` // ✅ 显式映射到 "user_id"
Title string `bson:"title" json:"title"`
}? 提示：建议同时为 Title 等字段添加 bson:"title"，确保读写一致性；omitempty 可按需添加（如不希望空字符串写入数据库）。
✅ 验证与最佳实践
- 检查数据库实际数据：用 mongo shell 或 Compass 确认集合中确实存在多条 user_id 匹配的文档；
-
启用日志调试（可选）：设置 session.SetSafe(&mgo.Safe{}) 并捕获 iter.Err()：
if err := iter.Err(); err != nil { log.Printf("Iterator error: %v", err) } - 避免结构体复用陷阱：确保 result 变量在循环内不被意外复用（当前写法安全）；
- 升级考虑：mgo 已停止维护，生产环境建议迁移到官方 mongo-go-driver，其标签规则更明确（bson:"user_id" 同样必需）。
? 总结
- Find().Iter() 本身支持返回全部匹配文档，“只返回第一条”通常是反序列化失败的表象，而非查询限制；
- 核心修复：所有参与数据库读写的字段必须有准确的 bson tag，json tag 仅用于 HTTP 序列化；
- 永远检查 iter.Err() —— 它是诊断迭代问题的第一线索；
- 结构体定义即契约：BSON 标签是 Go 与 MongoDB 之间字段映射的唯一权威依据。
