$unionwith 必须作为聚合管道的后续阶段使用，不能单独启动聚合；它要求字段逻辑对齐，缺失字段自动为 null；嵌套 pipeline 会独立执行且无深度限制但有内存风险；不保证合并顺序、不支持索引下推和事务。
为什么 $unionWith 在 MongoDB 4.4 中不能直接写在顶层 pipeline？
因为 $unionWith 是一个**阶段操作符（stage operator）**，不是聚合命令本身。你如果直接执行 db.collection.aggregate([ { $unionWith: "other" } ])，会报错 "$unionWith is not allowed in this context" —— 它必须出现在**已有集合的聚合管道中**，且只能作为后续阶段加入，不能单独启动聚合。
换句话说：你得先有个主集合（比如 orders），对它做一次聚合（哪怕只是 { $match: {} }），再用 $unionWith 拼另一个集合或子管道结果。
- 错误写法：
db.runCommand({ aggregate: "orders", pipeline: [ { $unionWith: "users" } ], cursor: {} }) - 正确起点：
db.orders.aggregate([ { $match: {} }, { $unionWith: "users" } ])
怎么让两个结构不同的集合也能 union？字段缺失怎么办
$unionWith 要求两边字段“逻辑对齐”，但 MongoDB 不强制 schema 一致。实际合并时，**缺失字段自动为 null**，不会报错，但可能引发后续 $group 或 $sum 阶段出问题（比如把 null 当 0 算）。
推荐在 $unionWith 前统一字段结构，尤其当字段名不一致或类型混杂时：
- 用
$project显式定义字段，补全缺失值：{ amount: { $ifNull: [ "$price", 0 ] } } - 重命名字段保持一致：
{ user_id: "$uid", order_time: "$created_at" } - 避免依赖隐式字段推断 —— 比如一边有
status，另一边是state，不重命名就会变成两个字段共存
示例（合并 orders 和 refunds，统一为 event_type 和 amount）：
db.orders.aggregate([
{ $project: { event_type: { $const: "order" }, amount: "$total", ts: "$order_date" } },
{ $unionWith: {
coll: "refunds",
pipeline: [
{ $project: { event_type: { $const: "refund" }, amount: { $multiply: [ -1, "$value" ] }, ts: "$refund_date" } }
]
}
}
])
$unionWith 的 pipeline 参数能嵌套多深？有没有性能隐患
$unionWith 的 pipeline 字段支持完整聚合管道（包括 $lookup、$facet），但注意两点：
- 嵌套 pipeline 会在 **union 前独立执行**，也就是说：如果
pipeline里有$match，它只过滤目标集合（如refunds），不影响主集合数据流 - 没有硬性深度限制，但每层
$lookup或$unwind都会放大内存和时间开销；实测在 4.4 中，若嵌套 pipeline 返回 >10 万文档，容易触发errmsg: "Exceeded memory limit for $unionWith" - 建议提前用
$limit控制子 pipeline 输出量，尤其在分页或调试阶段
另外，$unionWith **不支持索引下推优化** —— 即使两边都有 { status: 1 } 索引，union 后的 $match 也无法复用，所以尽可能把过滤条件下沉到各分支的 pipeline 里。
为什么 union 后排序失效或跳过部分数据
常见现象：加了 { $sort: { ts: -1 } } 在 $unionWith 后，结果顺序乱，或者总数变少。根本原因是：MongoDB 4.4 的 $unionWith **默认不保证顺序合并**，且若启用 allowDiskUse: true，中间结果落盘后排序逻辑可能被拆分处理。
- 确保全局有序：把
$sort放在$unionWith之后，且**不要跨分片**（sharded cluster 下$unionWith仅支持 unsharded 或同一分片内的集合） - 总数异常？检查是否用了
$limit在$unionWith前 —— 它只限制主集合输出，子 pipeline 不受控 - 更稳妥的做法：union 后立刻
$addFields打上来源标记，再$sort+$skip/$limit分页，避免混淆
真正容易被忽略的是：MongoDB 4.4 的 $unionWith **不支持在事务中使用**。如果你在 session.startTransaction() 里调这个阶段，会直接报 "$unionWith is not supported inside a transaction" —— 这个限制文档里没高亮，但线上踩过就记得牢。
