MongoDB 4.4 unionWith 联表查询使用详解

核心结论：MongoDB 4.4 版本中 $unionWith 虽然可用，但与 5.0 及更高版本存在显著差异。若忽视关键细节，开发中极易遇到问题，特别是 pipeline 参数支持、字段对齐以及合并顺序等方面需要额外处理。本文将结合实战经验，逐一解析这些关键要点。

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 操作出错。

在 MongoDB 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 版本中 $unionWith 最令人头疼的部分。若想如同 5.0+ 那样通过 pipeline: [] 一键完成，在 4.4 上只能借助组合阶段硬性处理。