跨集合移动数据必须在单个会话中完成，所有CRUD操作需显式传入session参数，否则事务失效；推荐先删后插、分页处理、确保集合存在与权限完备，并调用endSession()防止泄漏。
事务中跨集合移动数据必须用单个会话执行
在MongoDB中实现跨集合数据迁移，首要原则是确保所有操作在同一个会话（Session）内完成。MongoDB的事务机制本身不支持跨会话操作，这意味着所有相关的insertOne、deleteOne、updateOne等CRUD操作，都必须显式绑定到同一个session对象上。如果忽略这一步，事务上下文将立即中断，原子性保障也随之失效。
开发者常犯的错误是将“查询、删除、插入”流程拆分为独立的命令执行，或误以为对不同collection的写入会自动归入同一事务。实际上，默认情况下这些操作均以无会话模式执行，无法保证原子性。
正确做法是显式启动会话，并将所有操作串联绑定至该会话：
const session = client.startSession();
try {
await session.withTransaction(async () => {
await db.collection('orders').deleteOne({ _id: orderId }, { session });
await db.collection('archived_orders').insertOne({ ...doc, archived_at: new Date() }, { session });
});
} finally {
await session.endSession();
}
- 务必为每一个CRUD方法传入
session参数，遗漏任一操作都会使其脱离事务上下文。 - 避免在事务块外部对计划操作的文档进行读写（如先
findOne再进入事务），否则可能读取到过期数据快照或引发写冲突。 - 若在分片集群环境下执行跨集合操作，所有涉及集合必须拥有相同的分片键，否则事务将抛出
TransactionNotSupportedOnShardedCluster错误。
删除与插入必须共用同一 session 且顺序可控
在事务内部，操作顺序虽不影响最终的原子性结果（失败即全部回滚），但会显著影响锁持有时间与并发性能。不当的顺序易导致阻塞甚至死锁。
例如，若采用“先插入后删除”顺序，而目标文档（如归档表中已存在相同唯一键记录）已存在，则插入操作会立即失败，事务随之中止。相比之下，“先删后插”更符合数据移动的语义，也能避免失败时留下冗余数据。
- 推荐操作顺序：先执行
deleteOne或deleteMany，再执行insertOne或insertMany。 - 如需保留原始文档字段结构，应直接使用
doc._id等原生字段，避免手动拼接对象导致ObjectId或日期等特殊类型丢失。 - 注意：
insertOne不会自动覆盖_id相同的文档。若归档表允许同一文档多次归档，需确认是否使用upsert: true选项（此操作将使“移动”变为“迁移+更新”）。
事务超时和长时间运行会触发自动中止
MongoDB为事务设置了默认60秒的生命周期限制（由transactionLifetimeLimitSeconds参数控制）。跨集合大批量数据迁移时极易触发此限制。一旦事务超时，系统将自动中止（abort）。需警惕的是：已执行的删除操作可能无法回滚（因其可能在提交前已完成），而后续插入却尚未执行。
- 批量移动时务必进行分页处理，将单次事务处理的数据量控制在数百条以内（如每次100条）。
- 绝对避免在事务中调用外部API、执行文件读写或加入睡眠（sleep）操作，这些耗时均会计入事务总时间。
- 必要时可通过命令
db.adminCommand({ setParameter: 1, transactionLifetimeLimitSeconds: 300 })临时调高事务生命周期限制（注：此方法仅适用于副本集；分片集群需在每个分片上单独设置）。 - 监控长时间运行事务可使用
db.currentOp({ "secs_running": { "$gt": 30 } })查看运行超30秒的操作。
集合不存在或权限不足会在事务开始前就报错
事务不会延迟或忽略对集合存在性及用户权限的校验。若目标集合（如archived_orders）尚未创建，或当前用户缺乏对其的insert权限，则withTransaction调用将立即抛出异常，事务逻辑根本不会启动。
- 确保目标集合已存在，或提前使用
db.createCollection()命令创建（注意：创建集合命令不可在事务内部执行）。 - 验证操作账号权限：至少需具备
readWrite角色，且其作用域需覆盖源集合与目标集合（如db.orders和db.archived_orders）。 - 事务内部禁止执行创建索引、修改集合结构等DDL（数据定义语言）操作。
总而言之，跨集合移动数据的本质是一次“受严格约束的两步写入”，而非简单的“复制后删除”。最易被忽视的是会话生命周期管理——必须调用endSession()以防止连接泄漏。同时，由于withTransaction内部的重试机制可能多次执行回调，务必确保所有操作具备幂等性（例如使用条件明确的deleteOne，而非匹配范围不确定的deleteMany）。
