本文介绍如何在 Go 应用中使用 mgo 驱动（兼容旧版 MongoDB）向嵌套数组字段（如 categories）安全、高效地追加子文档，涵盖结构体定义、原子更新操作及关键注意事项。
本文介绍如何在 go 应用中使用 mgo 驱动（兼容旧版 mongodb）向嵌套数组字段（如 `categories`）安全、高效地追加子文档，涵盖结构体定义、原子更新操作及关键注意事项。
在 Go 中操作 MongoDB 时，若需向已有文档的数组字段动态添加子文档（例如为文章新增分类），推荐使用 MongoDB 的原子操作 $push，避免读-改-写带来的竞态风险。以下以 Article 结构为例进行完整说明：
首先，定义清晰的结构体并确保 BSON 标签正确映射：
type Category struct {
ID bson.ObjectId `bson:"_id,omitempty"`
Name string `bson:"name"`
Slug string `bson:"slug"`
}
type Article struct {
ID bson.ObjectId `bson:"_id,omitempty"`
Title string `bson:"title" json:"title" form:"title"`
Categories []Category `bson:"categories"` // 注意：建议用值类型切片而非指针切片，避免 nil 元素问题
}
✅ 关键改进说明：原问题中 Categories []*Category 使用指针切片虽可行，但易引发序列化异常或空指针 panic；实践中更推荐 []Category（值切片），MongoDB 驱动能自动处理嵌套文档的 BSON 编码。
插入新分类的核心逻辑使用 mgo.Change 执行原子更新：
cat := Category{
ID: bson.NewObjectId(),
Name: "Go Programming",
Slug: "go-programming",
}
change := mgo.Change{
Update: bson.M{"$push": bson.M{"categories": cat}}, // "$push" 向 categories 数组末尾追加
}
// 假设 repo.collection 已初始化，article 是有效的 ObjectIdHex 字符串
result := &Article{}
_, err := repo.collection.FindId(bson.ObjectIdHex(article)).Apply(change, result)
if err != nil {
log.Printf("Failed to add category: %v", err)
return err
}
? 重要注意事项：
- Apply() 方法要求目标文档必须已存在，否则返回 not found 错误；如需“存在则更新、不存在则创建”，应改用 Upsert() 并配合 $setOnInsert；
- 确保字段名 categories 与结构体 BSON 标签（bson:"categories"）完全一致，大小写敏感；
- mgo 已停止维护，生产环境强烈建议迁移到官方驱动 go.mongodb.org/mongo-driver，其语法更现代、上下文支持更完善；
- 若需去重插入，可将 $push 替换为 $addToSet（仅当 Category 结构中所有字段可比较且无重复语义时适用）。
总结：通过 $push 实现子文档追加是高效且线程安全的实践方式。结合合理的结构体设计与错误处理，即可稳健支撑内容管理类业务场景。
