MongoDB 4.2+ 支持在 updateOne/updateMany/findOneAndUpdate 中使用聚合管道数组实现服务端计算更新，必须用数组语法（如[{ $set: { total: { $multiply: ["$price", "$qty"] } }}]），对象语法不支持聚合表达式；仅允许 $set/$unset/$replaceWith 三类阶段；数组更新需配合 arrayFilters 选项；分片集不支持 $replaceWith；管道长度≤100；PyMongo 需≥3.9 版本。
MongoDB 4.2+ 支持在 updateOne、updateMany、findOneAndUpdate 中直接传入聚合管道（而非传统操作符对象），这是实现“服务端计算后更新”的关键能力。不用查出来再改，避免竞态和往返开销。
聚合管道更新必须用数组语法
传给 update 方法的第二个参数 update 必须是数组，不能是对象；否则会被当作传统操作符处理，导致 $set 里写 $multiply 这类表达式直接报错：
- ✅ 正确：
db.coll.updateOne({ _id: 1 }, [ { $set: { total: { $multiply: ["$price", "$qty"] } } } ]) - ❌ 错误：
db.coll.updateOne({ _id: 1 }, { $set: { total: { $multiply: ["$price", "$qty"] } } })—— 此时$multiply不被识别，报Unrecognized expression '$multiply'
本质区别在于：数组形式启用聚合管道上下文，支持所有聚合阶段和变量（如 $$NOW、$$REMOVE）；对象形式只认老式更新操作符（$set、$inc 等）。
只允许三个聚合阶段别名用于更新
不是所有聚合阶段都能用在 update 管道中。MongoDB 4.2+ 明确只支持以下三类阶段（及其别名），其他如 $match、$group、$sort 均非法：
-
$set（等价于$addFields）：添加或重算字段 -
$unset（等价于$project）：删除字段，或显式保留字段（需设为0） -
$replaceWith（等价于$replaceRoot）：用新文档完全替换原文档（注意：会丢弃_id，除非显式保留）
例如想删掉 tempFlag 并重算价格，得这样写：[ { $set: { priceWithTax: { $multiply: ["$price", 1.1] } } }, { $unset: "tempFlag" } ]。中间不能插 $match 来过滤——filter 已在第一个参数中完成。
数组字段更新要配合 arrayFilters
当管道里需要基于数组元素条件更新（比如“把 tags 数组中值为 'old' 的元素改成 'legacy'”），光靠 $[] 或 $[i] 不够，必须显式传 arrayFilters 选项：
- 错误写法（无
arrayFilters）：db.users.updateOne({ _id: 1 }, [ { $set: { "tags.$[t]": "legacy" } } ], { arrayFilters: [{ "t": "old" }] }) - 正确写法（带
arrayFilters）：db.users.updateOne({ _id: 1 }, [ { $set: { "tags.$[t]": "legacy" } } ], { arrayFilters: [{ "t": "old" }] })
注意：arrayFilters 是 update 方法的**第三个参数对象里的字段**，不是管道的一部分；且过滤器中变量名（如 t）必须和 $[t] 里的一致。漏掉 arrayFilters 会导致 Invalid array filter 错误。
性能与兼容性要注意的硬限制
聚合管道更新虽强大，但有实际约束：
- 不支持在分片集合上使用
$replaceWith阶段（会报Cannot use $replaceWith in a sharded collection） - 管道长度不能超过 100 个阶段（超限报
Exceeded maximum pipeline length） - 如果集群运行在 4.2 之前版本，该语法直接不识别，连接会断开或返回解析错误
- PyMongo 中调用时，确保 driver 版本 ≥ 3.9（对应 MongoDB 4.2 支持），否则
update_one传数组会被静默转成对象，计算逻辑失效
最易忽略的是 driver 兼容性——很多团队升级了 server 却没同步升级 PyMongo 或 Node.js driver，结果管道语法被降级处理，表面成功实则没生效。
