MGO 的 Upsert() 默认会整文档替换，需配合 $set 等更新操作符才能实现仅修改指定字段、保留其余字段不变的部分更新效果。
mgo 的 `upsert()` 默认会整文档替换，需配合 `$set` 等更新操作符才能实现仅修改指定字段、保留其余字段不变的部分更新效果。
在使用 MGO（gopkg.in/mgo.v2）操作 MongoDB 时，Collection.Upsert() 是一个常用方法，用于“有则更新、无则插入”。但一个常见误区是：直接传入普通 bson.M{} 作为更新参数，会导致整文档被替换（即丢失未显式指定的原有字段），而非预期的“仅更新部分字段”。
如问题中所示，以下写法是错误的：
db.C("users").Upsert(
bson.M{"email": "[email protected]"},
bson.M{"displayName": "My name was updated"}, // ❌ 错误：整文档替换！
)这会将匹配文档完全替换为 { "displayName": "My name was updated" }，原 email、password、age 等字段全部丢失。
✅ 正确做法是：将更新内容包装在 MongoDB 更新操作符中，最常用的是 $set：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
db.C("users").Upsert(
bson.M{"email": "[email protected]"},
bson.M{"$set": bson.M{"displayName": "My name was updated"}}, // ✅ 正确：仅设置 displayName 字段
)此时，若文档存在，则仅更新 displayName 字段；若不存在，则先插入一条新文档，其中包含查询条件字段（email）和 $set 中的字段（displayName），其他字段（如 _id）由 MongoDB 自动生成。
? 补充说明：
-
$set是幂等操作，安全可靠，推荐用于绝大多数部分更新场景； - 如需同时支持多字段更新、条件更新或删除字段，可组合使用
$unset、$inc、$addToSet等操作符； - 若需在插入时填充默认字段（如
createdAt、status），可在$set中一并声明，或使用$setOnInsert（MGO 支持）：
db.C("users").Upsert(
bson.M{"email": "[email protected]"},
bson.M{
"$set": bson.M{"displayName": "My name was updated"},
"$setOnInsert": bson.M{"createdAt": time.Now(), "status": "active"},
},
)⚠️ 注意事项：
- MGO 已归档（官方已停止维护），生产环境建议迁移到官方驱动
mongo-go-driver，其UpdateOne+Upsert: true选项语法更清晰、功能更完善； - 使用
Upsert前确保查询条件（如email）上有唯一索引，避免意外插入重复数据； - 操作前务必检查
err，并合理处理info.Updated与info.Removed返回值以区分是更新还是插入。
总结：MGO 的 Upsert 不是“智能合并”，而是“匹配 + 替换/插入”；要实现部分更新，必须显式使用 $set 等更新操作符——这是 MongoDB 协议层的设计约定，而非 MGO 的缺陷。
