mongodb中用$mergeobjects实现嵌套字段深度合并，需结合$replacewith进行聚合管道更新：外层$mergeobjects合并整个文档（$$root与更新对象），内层针对特定嵌套字段（如package）做精细合并，确保未提及字段不丢失。
用 $mergeObjects 合并嵌套字段，不是简单覆盖
直接用 $set 更新嵌套对象会整块替换，导致子字段丢失。比如想只更新 package.parameter 却保留 package.version，必须用聚合式更新配合 $mergeObjects。
核心结构是：{"$replaceWith": {"$mergeObjects": ["$$ROOT", {"package": {"$mergeObjects": ["$package", {"parameter": "v2"}]}}]}}。外层 $mergeObjects 合并整个文档，内层只针对 package 字段做精细合并。
-
$$ROOT引用原文档全量，确保其他字段不丢 - 内层
$mergeObjects的第一个参数必须是已有字段（如$package），不能写空对象或字面量对象 - MongoDB 4.2+ 才支持这种写法；低版本只能靠应用层拼接再
$set
用 $lookup + $mergeObjects 做跨集合字段合并
当需要把另一个集合的字段“补”到当前文档里（比如订单里加客户姓名），$lookup 拿到数据后，得用 $mergeObjects 把它和原文档合并，而不是直接 $addFields —— 后者会把整个关联结果塞进新字段，结构变深。
示例：把 customers 的 name 和 email 合并进 orders 文档顶层：
db.orders.aggregate([
{ $lookup: { from: "customers", localField: "customer_id", foreignField: "_id", as: "cust" } },
{ $unwind: "$cust" },
{ $replaceWith: { "$mergeObjects": ["$$ROOT", "$cust"] } },
{ $project: { cust: 0 } }
])
-
$unwind必须在$replaceWith前，否则$cust是数组，$mergeObjects会报错 -
$project去掉临时字段cust，避免冗余；不删的话字段名会残留 - 如果
$lookup可能无匹配，$unwind要加preserveNullish: true，再配合$ifNull处理
$merge 阶段不是合并字段，而是合并集合写入目标
名字带“merge”但功能完全不同：$merge 是把整个聚合结果输出到某个集合，支持按条件更新/插入/跳过，不是用来拼字段的。它必须是管道最后一个阶段，且会真实修改数据库。
常见误用：以为 $merge 能把两个字段值拼成一个字符串字段——不能。它只管“把这批文档存到哪、怎么存”。真正合并字段值要用 $concat、$mergeObjects 或 $reduce。
- 错误写法：
{$merge: {into: "temp", on: "_id", whenMatched: "merge"}}试图让字段合并——实际只是把当前文档按_id写入temp集合 - 正确场景：ETL 流程中把清洗后的订单数据合并进宽表集合，用
whenMatched: "replace"全量覆盖旧记录 - 注意权限：执行
$merge需要目标集合的insert和update权限，不是只读用户能跑的
数组字段合并容易漏掉 $reduce + $concatArrays
当多个分组结果要压平成一个大数组（比如把每个状态的订单列表合并成单个 allOrders 字段），不能只靠 $push 嵌套两层就完事。必须用 $reduce 配合 $concatArrays 展开。
典型结构：
{$group: { _id: "$status", items: {$push: "$$ROOT"} }},
{$group: { _id: null, allItems: {$push: "$items"} }},
{$project: { mergedList: { $reduce: { input: "$allItems", initialValue: [], in: {$concatArrays: ["$$value", "$$this"]} } } }}
- 第一层
$group按状态聚出数组，第二层再把所有状态数组包进一个更高维数组 -
$reduce的initialValue必须是空数组[]，否则$concatArrays会类型错误 - 别用
$unwind再$push，性能差且无法保证顺序；$reduce是唯一可控的扁平化方式
$mergeObjects 的参数顺序和 $$ROOT 的引用时机——字段合并不是字符串拼接，是对象层级的递归覆盖，错一层就丢数据。
