mongodb 4.4+ 支持在 updateone/updatemany/findoneandupdate 中直接传入聚合管道作为更新参数，需用 update 方法而非 aggregate()；允许 $set、$addfields 等写入阶段，禁止 $match、$sort 等；$project 会完全替换文档，须显式保留 _id；嵌套操作需用 $ifnull 防空字段报错；atlas 上还需 data access 权限。
MongoDB 4.4+ 支持在 updateOne、updateMany、findOneAndUpdate 中直接传入聚合管道作为更新参数，这是真正可执行写操作的“可更新聚合管道”——不是只读的 aggregate()，而是能修改数据的更新逻辑。
必须用 update 方法 + 聚合管道，不能用 aggregate()
很多人把「聚合管道」等同于 db.collection.aggregate()，但这个方法默认只读；要更新，必须显式调用更新方法，并把管道放在第二个参数（即更新操作符位置）：
-
db.coll.updateOne({ category: "A" }, [ { $set: { updatedAt: "$$NOW" } } ])—— 正确：管道作为第二个参数 -
db.coll.aggregate([ { $set: { updatedAt: "$$NOW" } } ])—— 错误：不改任何数据，除非加$merge或$out - 驱动中也要对应：Node.js 用
collection.updateOne(filter, pipeline)，不是collection.aggregate(pipeline)
$set、$addFields 等阶段可用，$match 和 $sort 无效
更新管道里不是所有聚合阶段都合法。MongoDB 只允许写入类阶段，且它们作用于单个匹配文档（不是流式处理）：
- ✅ 允许：
$set、$addFields、$project（重投影字段）、$unset、$replaceWith - ❌ 禁止：
$match（过滤无意义，外层已有 filter）、$sort、$skip、$limit、$group、$unwind（会报错 “Unrecognized pipeline stage name”） - ⚠️ 注意：
$project在更新管道中行为特殊——它会**完全替换整个文档内容**，除非你显式保留_id和其他必要字段
嵌套数组 upsert 场景下，$cond + $map 是核心模式
比如向 list 数组中按 item: 1 查找对象，存在则 push 到其 sub_list，不存在则插入新对象。关键不是“怎么写条件”，而是“怎么避免空字段崩溃”：
- 所有数组访问必须包裹
$ifNull：$ifNull: ["$list", []]，否则$map遇到缺失list字段直接报错 - 用
$in检查存在性：{ $in: [1, { $map: { input: "$list", as: "x", in: "$$x.item" } }] }，别用$elemMatch—— 它在管道里不支持字段引用 -
$mergeObjects合并时，确保目标字段是数组：sub_list: { $concatArrays: ["$$this.sub_list", [11]] }，而不是$push（$push不允许在更新管道中使用）
版本和权限陷阱：4.4 是底线，Atlas 上还要开 Data Access
即使语法全对，也可能静默失败：
- 本地部署 MongoDB errmsg: "The 'pipeline' option is only supported on MongoDB 4.2+"（注意：4.2 支持但仅限
$set等极简管道；完整能力从 4.4 起） - 在 Atlas UI 用聚合管道构建器做更新？需要账号有
Data Access Read and Write权限，Read Only不行 - 驱动连接字符串没加
?retryWrites=true？某些旧版驱动在更新管道中会丢掉写确认，看似成功实则未持久化
真正容易被忽略的是：更新管道里的表达式无法引用“其他文档”，它只作用于当前匹配的那一条文档；所有“跨文档逻辑”（比如累计值、关联更新）必须靠应用层协调或预计算字段支撑。
