MongoDB 4.4版本中如何使用unionWith执行联表查询？

MongoDB 4.4 的 $unionWith 仅支持字符串集合名，不支持 pipeline 参数；字段需提前用 $project 统一，合并后顺序不可控，须显式 $sort；Java 中需手写 Document 调用。

4.4 版本支持 $unionWith，但不支持 pipeline 参数

MongoDB 4.4 确实引入了 $unionWith，但它只接受字符串形式的集合名，比如 {$unionWith: "admins"}，**不支持 pipeline 字段**。这是和 5.0+ 最关键的区别——4.4 的 $unionWith 没有 pipeline 选项，所以无法在联合时对目标集合做 $match、$project 等预处理。

常见错误是直接照搬 5.0+ 写法，比如：

{$unionWith: { coll: "admins", pipeline: [{$match: {active: true}}] }}

这在 4.4 会报错：unrecognized field 'pipeline'。

• 4.4 只允许简写形式：{$unionWith: "targetCollection"}
• 若需过滤或字段对齐，必须提前在源集合或目标集合上单独加 $match/$project 阶段（不能嵌套在 $unionWith 里）
• 两个集合字段不一致时，缺失字段不会自动补 null，而是直接不出现——容易导致后续 $group 或 $sum 出错

如何让 4.4 的 $unionWith 输出结构一致？

如果 orders 和 returns 集合字段不同（比如前者有 amount，后者是 refund），直接 $unionWith 后字段会错乱。必须用 $project 统一输出结构。

正确做法是：在每个集合的数据流里先做字段映射，再 union。

• 先对主集合做 $project，把字段重命名为统一别名，如 {value: "$amount"}
• 再用 $unionWith: "returns"，但注意：4.4 不允许给 returns 单独加 pipeline，所以得提前建视图或改写查询逻辑
• 更稳妥的方式是建一个中间视图：db.createView("unified_events", "orders", [{$project: {type: "order", value: "$amount", ts: "$createdAt"}}])，再对 returns 做同样视图，最后查视图并 union

4.4 中实现 UNION ALL 语义的实际限制

$unionWith 在 4.4 中默认不去重，这点和 SQL 的 UNION ALL 行为一致，但**顺序完全不可控**——即使两个集合各自有序，合并后文档顺序是随机的。

• 不能依赖自然插入顺序，也不能靠 _id 排序隐含保证
• 如果需要按时间归并（如日志表 logs_202401 + logs_202402），必须在 $unionWith 后显式加 $sort，例如 {$sort: {timestamp: 1}}
• 但要注意：4.4 对内存排序有限制，大结果集没索引支撑时容易触发 Sort exceeded memory limit
• 若只是取前 20 条，分别查两个集合 + 应用层归并（按时间字段 merge sort），比全量 union 再 $skip/$limit 更快更稳

Java 中用 MongoTemplate 调用 $unionWith 的写法

MongoTemplate 4.x（对应 MongoDB 4.4）没有封装 $unionWith 的 Criteria 方法，必须用原生 BSON 构造。

• 不能用 Aggregation.newAggregation(...) 直接链式调用 $unionWith
• 要手写 Document： new Document("$unionWith", "admins")
• 整个聚合管道得用 Aggregation.aggregate(..., new Document(...)) 方式传入
• 字段不一致时，Java 层拿到的 Map 可能缺少某些 key，建议用 @Document 类定义统一 DTO，配合 $project 显式映射字段

真正麻烦的不是语法，而是字段对齐和顺序控制——这些在 4.4 里都得靠组合阶段硬扛，没法像 5.0+ 那样用 pipeline: [] 一键保底。