$out会完全覆盖目标集合，包括数据、索引、ttl及分片配置；它本质是创建临时集合后原子重命名替换，不参与事务，无法与insertone等写操作构成跨操作原子性。
为什么$out不能和其它写操作混用
$out 阶段会**完全替换目标集合**，包括索引、权限、TTL等元信息。它不是追加，也不是事务内的一部分——MongoDB 的聚合管道本身不参与事务的原子性保障（即使在外层开启事务，$out 也会被拒绝执行）。你看到的「原子性」仅指：整个 $out 操作要么全部成功（新集合完整覆盖），要么全部失败（原集合不受影响），但这个过程无法与 insertOne、updateMany 等其它写操作构成跨操作的原子性。
- 在副本集上，
$out实际是先建临时集合，再原子性地重命名（renameCollection），所以对读端表现为「瞬间切换」 - 如果聚合中途出错（如内存超限、类型错误），目标集合保持原样，不会残留半截数据
- 但如果你在
$out前后还调用了db.collection.insertOne()，这两者之间没有任何原子性保证
如何安全地用$out生成带索引的新集合
很多人以为 $out 写完就完事了，结果应用一查发现慢得不行——因为新集合默认没索引。MongoDB 不会继承源集合的索引，也不会自动创建任何索引。必须手动补。
- 先执行聚合 +
$out，例如：db.orders.aggregate([ { $match: { status: "completed" } }, { $group: { _id: "$customerId", total: { $sum: "$amount" } } }, { $out: "customer_totals" } ]) - 紧接着运行
db.customer_totals.createIndex({ _id: 1 })或更实用的db.customer_totals.createIndex({ customerId: 1 })（注意字段名要和聚合输出一致） - 索引创建可加
{ background: true }避免阻塞，但需确保 MongoDB 版本 ≥ 4.2（早期版本 background 索引在$out后不可靠）
替代方案：当需要真正跨操作原子性时该怎么做
如果你的业务逻辑要求「聚合结果写入 + 同时更新状态集合 + 记录日志」三者不可分割，$out 就不该出现在这个流程里。这时候得退回到应用层协调。
- 用
$facet或两次聚合分别获取数据和统计值，用toArray()拉到内存（注意内存和超时限制） - 开启多文档事务（仅支持 replica set / sharded cluster with featureCompatibilityVersion ≥ 4.0）
- 在事务中依次调用：
session.startTransaction()→db.customer_totals.deleteMany({})→db.customer_totals.insertMany(results)→db.job_log.insertOne({...})→session.commitTransaction() - 注意：事务有 60 秒时间限制，且不支持
$out、$merge等写集合阶段
$out 和 $merge 的关键区别与选型建议
别只盯着「能写进去」，要看后续怎么维护。很多团队踩坑是因为把 $out 当成万能导出工具，却忽略了它彻底抹掉旧集合的事实。
-
$out：适合离线报表生成、ETL 中间表重建、数据归档等「全量覆盖」场景；目标集合名必须是硬编码字符串，不能拼接变量 -
$merge：支持 upsert、字段映射、条件匹配，可增量更新；但要求目标集合已存在，且 MongoDB ≥ 4.2；性能开销略高（需做 lookup 匹配） - 如果只是想「追加当天聚合结果」，
$merge是唯一合理选择；用$out每天覆盖，等于主动丢弃历史分区信息 -
$merge的on字段必须有索引，否则会触发 collection scan，聚合可能直接超时
$out 看似简单，但它把「数据一致性责任」从数据库推给了人。
