mongodb 4.2起updateone/updatemany支持聚合管道更新，可原子执行字段求和等计算；需用数组传入$set阶段并配合$add、$ifnull等表达式，不可混用传统语法。
MongoDB 4.2 起，updateOne 和 updateMany 支持直接传入聚合管道，无需先查再算再写——两个字段求和这类计算更新，完全可在服务端原子完成，避免应用层往返和竞态问题。
用 $set + $add 在管道中实时计算字段和
旧方式要先 findOne 拿出 val1 和 val2，PHP/JS 里加完再 updateOne 写回去；新方式把加法逻辑压进数据库执行，一行管道搞定：
-
$set阶段支持表达式，可引用当前文档字段（用$field语法） -
$add是聚合表达式，接受多个数值参数，自动处理null或缺失字段（结果为null） - 必须用数组形式传入管道，不能混用传统
$set: { total: ... }写法
示例：给 _id: 123 的文档计算 val1 + val2 并存入 total
db.collection.updateOne(
{ _id: 123 },
[
{
$set: {
total: { $add: ["$val1", "$val2"] }
}
}
]
)
若 val1 为 10、val2 为 20，执行后 total 值为 30；任一字段不存在或为 null，total 就是 null。
处理空值或默认值：用 $ifNull 包一层
直接 $add 遇到 null 会返回 null，而不是按 0 处理。如果业务要求“空当 0 算”，得显式兜底：
-
$ifNull: ["$val1", 0]表示：若val1为null或缺失，取 0 - 嵌套在
$add里即可实现“空值归零相加” - 注意：字符串数字（如
"10"）不会被自动转成数字，$add会报错
带默认值的写法：
db.collection.updateOne(
{ _id: 123 },
[
{
$set: {
total: {
$add: [{ $ifNull: ["$val1", 0] }, { $ifNull: ["$val2", 0] }]
}
}
}
]
)
更新同时修改其他字段或加时间戳
管道允许多个阶段串联，比如一边算和，一边更新状态、记录时间：
-
$$NOW是聚合变量，代表服务器当前时间（ISODate 格式） - 一个管道里可以连续
$set多个字段，顺序执行，互不影响 - 不能在同一个
$set阶段里让新字段依赖刚设的字段（如先设a再设b: "$a"），因为字段不是立即可见的
示例：算和 + 更新 status + 记录 updated_at
db.collection.updateOne(
{ _id: 123 },
[
{
$set: {
total: { $add: ["$val1", "$val2"] },
status: "processed",
updated_at: "$$NOW"
}
}
]
)
常见错误：混淆传统更新操作符和管道语法
最常踩的坑是把管道写成老式更新格式，导致报错：
- ❌ 错误：
updateOne({ _id: 123 }, { $set: { total: { $add: ["$val1", "$val2"] } } })→ 报错Unknown modifier: $add - ❌ 错误：
updateOne({ _id: 123 }, [ { $set: { total: "$val1 + $val2" } } ])→ 字符串不解析，存的是字面量 - ✅ 正确：第二个参数必须是**数组**，且每个元素是合法聚合阶段对象（如
{ $set: { ... } }） - ⚠️ 注意：
$merge不是更新操作符，它是聚合命令里的独立阶段，不能用于update管道，否则报Unknown modifier: $merge
真正容易被忽略的是：管道更新不支持 arrayFilters 选项（它只对传统操作符生效），如果要基于数组元素条件计算，得改用 $map + $reduce 等更复杂的表达式，而不是依赖 arrayFilters 过滤后再算。
