核心结论：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 上只能借助组合阶段硬性处理。
