本文详解如何使用 MongoDB 的 $inc 操作符，在一次 findAndModify（或 Go 中的 Apply）调用中，原子性地对文档内两个或多个数值字段执行增量更新，避免多次往返与竞态风险。
本文详解如何使用 mongodb 的 `$inc` 操作符，在一次 `findandmodify`（或 go 中的 `apply`）调用中，原子性地对文档内两个或多个数值字段执行增量更新，避免多次往返与竞态风险。
在实际开发中，常需对文档中多个计数类字段（如 score、hist_score、login_count 等）进行同步增量操作。若分别发起两次更新，不仅增加网络开销，更可能因并发写入导致数据不一致——例如中间被其他操作修改，使最终结果偏离预期。MongoDB 提供的原子更新操作符（如 $inc）天然支持多字段批量更新，只需正确构造更新文档即可。
✅ 正确语法：单 $inc 包含多个键值对
$inc 操作符接受一个嵌套文档，其中每个键为待更新的字段路径，值为要增加的数值（支持正负整数/浮点数）。无需重复书写 $inc，所有字段统一置于同一 bson.M{"$inc": ...} 内：
change := mgo.Change{
Update: bson.M{
"$inc": bson.M{
"score": 20, // score += 20
"hist_score": 10, // hist_score += 10
"attempts": 1, // 可扩展至任意数量字段
},
},
ReturnNew: true,
}
err := collection.Find(bson.M{"_id": id}).Apply(change, &doc)
if err != nil {
log.Fatal(err)
}? 字段路径支持点号（dot notation）：如需更新嵌套字段（例如 stats.total 或 history.2024.score），直接使用 "stats.total" 或 "history.2024.score" 作为键名即可，MongoDB 自动解析路径并递归创建缺失的中间对象（若字段不存在，将初始化为 0 后再增量）。
⚠️ 注意事项与最佳实践
- 原子性保障：整个 $inc 操作在服务端以原子方式执行，无论更新多少个字段，都属于同一个写操作，杜绝中间状态暴露。
- 类型安全：目标字段必须为数字类型（int, float64, decimal128 等），否则会报错 Cannot increment with non-numeric argument。建议在 schema 设计阶段确保相关字段类型明确。
- 零值处理：若字段不存在，MongoDB 默认将其初始化为 0 后执行增量；若需避免隐式创建，可先用 $exists 查询校验，或结合 $setOnInsert 控制初始化逻辑。
-
Go 驱动兼容性：上述写法适用于 mgo（v2 及 legacy）；若使用官方 mongo-go-driver，语法类似，仅需将 mgo.Change 替换为 options.FindOneAndUpdateOptions.SetReturnDocument(options.After)，更新部分结构一致：
update := bson.M{"$inc": bson.M{"score": 20, "hist_score": 10}} result := collection.FindOneAndUpdate(ctx, bson.M{"_id": id}, update, options.FindOneAndUpdate().SetReturnDocument(options.After))
✅ 总结
一条 $inc 命令即可安全、高效、原子地更新多个数值字段——这是 MongoDB 原生支持的核心能力，也是高并发场景下的推荐实践。关键在于摒弃“逐字段更新”的思维惯性，善用操作符的复合表达能力。代码更简洁，逻辑更健壮，性能更优。
