本文详解如何通过 MongoDB 的 $inc 操作符，在一次 findAndModify（或 Go 中的 Apply）调用中，原子性地递增文档中两个或多个数值字段（如 score 和 hist_score），避免多次往返与并发风险。
本文详解如何通过 mongodb 的 `$inc` 操作符，在一次 `findandmodify`（或 go 中的 `apply`）调用中，原子性地递增文档中两个或多个数值字段（如 `score` 和 `hist_score`），避免多次往返与并发风险。
在实际开发中，常需对文档内多个计数类字段（如用户积分、历史得分、访问次数等）进行同步递增。若分别执行两次更新，不仅增加网络开销，更可能因并发写入导致数据竞争或丢失更新。MongoDB 提供了强大的原子更新操作符——$inc，它天然支持单次操作批量修改多个字段，确保强一致性与高性能。
✅ 正确语法：在 $inc 中声明多个键值对
$inc 接收一个嵌套文档（即 bson.M），其中每个键为待更新的字段路径，值为要增加的数值（支持正负整数或浮点数）。例如：
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)
}? 提示：字段名支持点号（.）表示嵌套路径，例如 "stats.total" 或 "achievements.gold.count"，适用于复杂文档结构。
⚠️ 注意事项与最佳实践
原子性保障：整个 $inc 操作在服务端以原子方式执行，无论更新多少字段，均属单次写入，无中间状态暴露。
类型安全：被 $inc 修改的字段必须为数值类型（int, float64 等），否则将报错 Cannot increment with non-numeric value。建议在 schema 设计阶段初始化为 0。
零值处理：若字段不存在，$inc 会自动创建并设为指定增量值（如 "new_field": 5 → 新增字段值为 5）。
-
Go 驱动兼容性：上述示例基于 mgo（已归档），若使用官方 mongo-go-driver，语法略有不同，核心逻辑不变：
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 的基础但关键能力。它简化逻辑、提升性能、强化数据一致性。开发者应摒弃“逐字段更新”的惯性思维，优先采用这种声明式、原子化的更新模式——尤其在高并发积分系统、实时统计、排行榜等场景中，其价值尤为突出。
