本文详解如何在 go 中使用 mgo 驱动（v2.0.x）向
mongodb
文档的嵌套数组（如 `camps`、`instructors`）安全、高效地追加新对象，涵盖完整代码示例、关键参数说明及生产环境注意事项。
在 MongoDB 应用开发中，常需对已有文档的数组字段动态追加元素（如为用户添加新营地、新增教练信息）。mgo 驱动虽已归档（官方推荐迁移至
mongo-go-driver
），但在遗留系统维护或学习场景中仍广泛使用。其核心机制是通过 $push 更新操作符实现数组末尾插入，配合 Update() 方法完成原子性写入。
以下是一个完整、可运行的示例，演示如何向 camps 数组追加一个新营地对象：
✅ 关键要点说明：bson.M{"$push": ...} 是 MongoDB 原生更新操作符，在 mgo 中直接映射为 BSON 对象；$push 默认追加到数组末尾，若需去重可改用 $addToSet；c.Update() 仅更新第一个匹配文档；如需批量更新，请使用 c.UpdateAll() 并传入 nil 作为更新结果接收器；查询字段（如 ownerEmail）建议建立索引以提升性能：db.stack.createIndex({"ownerEmail": 1})。
⚠️
重要注意事项
：
go语言参考手册 中文CHM版
Go 是一个开源的编程语言，它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册，需要的可以来下载！ Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发，后来还加入了Ian Lance Taylor, Russ Cox等人，并最终于2009年11月开源，在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的，并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译
下载
安全性
：生产环境务必避免硬编码连接字符串，应通过环境变量或配置中心管理；
错误处理
：mgo.ErrNotFound 是常见非致命错误，需显式判断并友好提示，而非直接 panic；
并发安全
：*mgo.Session 不是 goroutine 安全的，每个协程应调用 session.Copy() 获取独立会话副本；
驱动演进提醒
：mgo 已停止维护，新项目请优先选用官方
mongo-go-driver
，其 $push 写法为：
掌握 $push 在 mgo 中的正确用法，是构建灵活、可扩展 MongoDB 应用的基础能力。合理设计数据模型（如数组长度限制、索引策略）与严谨的错误处理，将显著提升服务稳定性与可维护性。
package main
import (
"fmt"
"log"
"time"
"gopkg.in/mgo.v2"
"gopkg.in/mgo.v2/bson"
)
func main() {
// 1. 建立连接（建议使用连接池与超时控制）
session, err := mgo.DialWithTimeout("mongodb://127.0.0.1:27017", 10*time.Second)
if err != nil {
log.Fatal("Failed to connect to MongoDB:", err)
}
defer session.Close()
// 2. 设置读写模式（Monotonic 模式兼顾性能与一致性）
session.SetMode(mgo.Monotonic, true)
// 3. 获取集合句柄
c := session.DB("test").C("stack")
// 4. 构建查询条件与更新操作
query := bson.M{"ownerEmail": "[email protected]"}
update := bson.M{
"$push": bson.M{
"camps": bson.M{
"name": "cubs-waco",
"location": "waco",
"createdAt": time.Now(), // 可选：添加时间戳增强可追溯性
},
},
}
// 5. 执行原子更新（仅匹配首个文档）
err = c.Update(query, update)
if err != nil {
if err == mgo.ErrNotFound {
fmt.Println("⚠️ 未找到匹配的文档，请检查 ownerEmail 是否正确")
} else {
log.Fatal("Update failed:", err)
}
return
}
fmt.Println("✅ 成功向 camps 数组追加新对象")
}filter := bson.M{"ownerEmail": "[email protected]"}
update := bson.M{"$push": bson.M{"camps": bson.M{"name": "cubs-waco", "location": "waco"}}}
result, _ := collection.UpdateOne(ctx, filter, update)