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: [] 一键保底。
