本文详解如何使用 MongoDB 的 $inc 操作符在一次 findAndModify（或 UpdateOne）操作中原子性地递增多个数值字段，避免多次往返数据库，并提供 Go 语言（基于 mgo 或现代 mongo-go-driver）的正确实现与注意事项。
本文详解如何使用 mongodb 的 `$inc` 操作符在一次 `findandmodify`（或 `updateone`）操作中原子性地递增多个数值字段，避免多次往返数据库，并提供 go 语言（基于 `mgo` 或现代 `mongo-go-driver`）的正确实现与注意事项。
在 MongoDB 中，对文档内多个数值字段执行原子性递增（如积分、历史得分、访问计数等）是一项高频需求。与其分别调用多次更新操作，更高效、更安全的方式是在单条更新命令中批量修改多个字段——这不仅减少网络开销，还能确保操作的原子性（即全部成功或全部失败），避免中间状态不一致。
核心原理在于 MongoDB 的更新操作符 $inc 支持多字段键值对语法：它接受一个嵌套文档，其中每个键为待更新的字段路径，值为对应的增量数值。语法结构如下：
{ "$inc": { "field1": 20, "field2": 10, "nested.field": 5 } }✅ 注意：字段名支持点号（.）表示嵌套路径（如 "profile.stats.views"），无需额外封装；所有字段将在同一原子操作中被更新。
Go 示例（兼容 mgo 与 mongo-go-driver）
使用 legacy mgo（如原问题所示）：
change := mgo.Change{
Update: bson.M{
"$inc": bson.M{
"score": 20, // 主得分 +20
"hist_score": 20, // 历史得分同步 +20
"attempts": 1, // 可选：额外字段一并递增
},
},
ReturnNew: true,
}
err := collection.Find(bson.M{"_id": id}).Apply(change, &doc)
if err != nil {
log.Fatal("Update failed:", err)
}
// doc 现在包含更新后的最新文档（含所有已递增字段）使用现代官方驱动 go.mongodb.org/mongo-driver/mongo（推荐）：
filter := bson.M{"_id": id}
update := bson.M{
"$inc": bson.M{
"score": 20,
"hist_score": 20,
},
}
result := collection.FindOneAndUpdate(context.TODO(), filter, update,
options.FindOneAndUpdate().SetReturnDocument(options.After),
)
if result.Err() != nil {
log.Fatal("Update failed:", result.Err())
}
var updatedDoc bson.M
if err := result.Decode(&updatedDoc); err != nil {
log.Fatal("Decode failed:", err)
}关键注意事项
- 字段必须为数值类型：$inc 仅适用于整数、浮点数或可转换为数字的字段。若目标字段不存在，MongoDB 会自动创建并初始化为指定增量值（如 "score" 不存在 → 设为 20）。
- 负数同样有效："score": -5 表示递减 5，适用于扣分等场景。
-
避免混合操作符冲突：单个 $inc 对象内不可重复声明同一字段；如需同时递增+设置其他字段，请组合使用 $inc 和 $set：
bson.M{ "$inc": bson.M{"score": 20}, "$set": bson.M{"last_updated": time.Now()}, } - 性能与事务提示：单命令多字段更新天然具备原子性，无需显式事务；但在分片集群中，需确保查询条件（如 _id）能精准路由至单一分片，否则可能报错。
掌握 $inc 的多字段语法，是构建高并发、数据强一致应用的重要基础。始终优先使用单命令批量更新，而非循环多次 Apply 或 UpdateOne —— 简洁、高效、可靠。
