本文详解 mgo 中 collection.Find(nil).All() 无法返回预期数据的典型原因，重点指出日志输出对象错误、结构体字段映射缺失等常见陷阱，并提供可验证的调试方案与最佳实践。
本文详解 mgo 中 `collection.find(nil).all()` 无法返回预期数据的典型原因，重点指出日志输出对象错误、结构体字段映射缺失等常见陷阱，并提供可验证的调试方案与最佳实践。
在使用 mgo（v2.0.0 及更早版本）连接 MongoDB 时，collection.Find(nil).All(&users) 返回 nil 错误但结果为空，往往并非查询失败，而是逻辑误判或数据映射问题。你提供的代码中 err 确实为 <nil></nil>，说明查询执行成功——但真正的问题藏在后续处理环节。
? 核心问题定位
首先，请检查最关键的误用点：
fmt.Println("Results >> ", err) // ❌ 错误：打印的是 err（始终为 nil），而非实际查询结果
应改为：
fmt.Println("Results >> ", users) // ✅ 正确：打印查询得到的 users 切片
若 users 仍为空（[]），则需进一步验证数据映射是否匹配。
? 结构体字段映射必须严格对齐 BSON 字段名
mgo 依赖 bson tag 将 Go 字段与 MongoDB 文档字段一一对应。你的 User 结构体定义如下：
type User struct {
Email string `json:"email" bson:"email"`
Pass string `json:"pass" bson:"pass"`
}
⚠️ 注意：MongoDB 中文档字段名区分大小写，且必须完全一致。例如，若数据库中实际存储的是 "email"（小写），而文档中误存为 "Email" 或 "EMAIL"，则 mgo 无法反序列化，users 将保持空切片（无报错，因反序列化失败不触发 err）。
✅ 推荐做法：添加 _id 字段并启用 ObjectId 支持（即使不显式使用）：
type User struct {
ID bson.ObjectId `bson:"_id,omitempty"`
Email string `json:"email" bson:"email"`
Pass string `json:"pass" bson:"pass"`
}
? 调试技巧：绕过结构体，用 []interface{} 快速验证原始数据
当不确定字段映射是否准确时，优先用泛型方式查看原始 BSON 数据：
session := dbConnect()
collection := session.DB("my_db").C("users")
var raw []interface{}
err := collection.Find(nil).All(&raw)
if err != nil {
log.Fatal("Mongo collection find fail: ", err)
}
fmt.Printf("Raw results (%d items): %+v\n", len(raw), raw)
此方法可直观确认：
- 集合是否真有数据（
len(raw) > 0）； - 实际 BSON 字段名（如是
"email"还是"user_email"）； - 字段类型是否匹配（如
Pass是否被存为int或null）。
✅ 完整可运行示例（含错误处理与验证）
func listUsers() {
session := dbConnect()
defer session.Close() // 记得关闭会话！
collection := session.DB("my_db").C("users")
// Step 1: 检查集合文档数量（快速验证数据存在性）
count, err := collection.Count()
if err != nil {
log.Fatal("Count failed:", err)
}
fmt.Printf("Total documents: %d\n", count)
// Step 2: 查询全部用户
var users []User
err = collection.Find(nil).All(&users)
if err != nil {
log.Fatal("Find.All failed:", err)
}
// Step 3: 输出结果（不是 err！）
fmt.Printf("Fetched %d users:\n", len(users))
for i, u := range users {
fmt.Printf("[%d] Email: %s, Pass: %s\n", i+1, u.Email, u.Pass)
}
}
⚠️ 注意事项总结
-
mgo已归档（官方已停止维护），生产环境强烈建议迁移到官方驱动mongo-go-driver； -
Find(nil)等价于{}，即匹配全部文档；但大数据集务必加.Limit(n)或分页，避免内存溢出； - 始终
defer session.Close()，防止连接泄漏； - 使用
bson.ObjectIdHex("...")构造 ID 时确保字符串合法，否则All()可能静默失败。
通过以上步骤，90% 的“查询无结果但无错误”问题均可定位并解决。核心口诀：先看 raw 数据，再核对 bson tag，最后检查输出对象——别再打印 err 了！
