本文介绍如何利用 mgo.v2 的 count() 方法轻量、安全地判断 mongodb 集合中是否存在匹配文档，避免反序列化开销和错误字符串比对，提升代码健壮性与可读性。
本文介绍如何利用 mgo.v2 的 count() 方法轻量、安全地判断 mongodb 集合中是否存在匹配文档，避免反序列化开销和错误字符串比对，提升代码健壮性与可读性。
在实际开发中，经常需要仅确认某条文档是否已存在（例如防止重复插入、实现幂等接口），而无需获取文档内容本身。此时若使用 Find().One(&result) 并依赖 err.Error() == "not found" 判断，不仅耦合了错误消息字符串（易受版本/语言环境影响），还需声明冗余变量（如 var res interface{}），更可能因反序列化大文档带来不必要的内存与 CPU 开销。
推荐做法是使用 Count() 方法——它仅向 MongoDB 发送聚合计数请求（底层对应 countDocuments 或兼容的 count 命令），不传输文档数据，也不触发结构体解码，语义清晰且性能最优：
// 检查 title 为 "title1" 的文档是否存在
count, err := col.Find(bson.M{"title": "title1"}).Count()
if err != nil {
log.Printf("查询计数时发生错误: %v", err)
return
}
exists := count > 0
if exists {
log.Println("文档已存在")
} else {
log.Println("文档不存在")
}✅ 优势总结：
- 零反序列化开销：不加载任何文档字段，内存友好；
- 错误处理健壮：仅需处理真实网络或权限类错误，无需解析错误字符串；
- 语义明确：Count() > 0 直观表达“存在性”意图；
- 兼容性强：mgo.v2 中 Count() 在所有 MongoDB 版本下均稳定可用（自动降级适配）。
⚠️ 注意事项：
- 确保查询条件（如 bson.M{"title": "title1"}）已建立对应索引，否则 Count() 在大数据集上可能变慢；
- 若需原子性判断+插入（如 upsert 场景），应改用 Upsert() 或事务，Count() + Insert() 组合存在竞态风险；
- mgo.v2 已归档不再维护，新项目建议迁移到官方驱动 go.mongodb.org/mongo-driver/mongo，其对应方法为 collection.CountDocuments(ctx, filter)。
综上，Count() 是检查文档存在的首选方案——简洁、高效、专业。
