Mongoose+MongoDB：带Session批量创建文档为何需设置ordered:true？

问题 #

使用mongoose@8.13.2搭配mongodb@6.15.0，尝试在Mongoose中用create()结合session实现事务支持时，批量插入文档触发错误：

Cannot call create() with a session and multiple documents unless ordered: true is set

相关代码：

async create(
  payload: Array<Partial<OrderDocument>>,
  options?: CreateOptions,
) {
  try {
    return this.orderModel.create(payload, { ...options, ordered: true });
  } catch (error) {
    throw error;
  }
}

调用方式：

const create = await this.ordersDBController.create([],{ session });

场景说明：传入文档数组作为payload，options携带session用于事务，仅同时使用session和多文档时触发错误。已按提示添加{ ordered: true }解决问题，但有以下疑问：

1. 为何使用session和多文档调用create()时必须设置ordered:true？
2. 这是否是推荐方案，或是有更好的带session批量插入方式？
3. 这会对批量插入的性能或错误处理方式产生影响吗？

解答 #

1. 为何必须设置ordered:true？ #

MongoDB事务要求操作串行有序执行，以此保证事务的原子性——要么所有操作成功提交，要么全部失败回滚。当设置ordered: false时，MongoDB会并行处理批量插入的文档，这种并行模式和事务的串行执行逻辑冲突，无法满足原子性约束。Mongoose作为ODM会强制校验这种冲突，因此要求事务session下的批量插入必须显式设置ordered: true。

2. 是否为推荐方案，或有更好的方式？ #

设置ordered: true是官方认可的合规方案。除此之外，也可以使用insertMany()替代create()，两者参数逻辑一致，同样需要在事务session下设置ordered: true。两者的核心差异在于：create()会触发Mongoose的中间件（如pre('save')、post('save')），而insertMany()默认不触发（需显式配置runValidators: true等选项才会执行校验或中间件）。如果业务不需要依赖Mongoose中间件，insertMany()也是可行选择。

3. 对性能和错误处理的影响？ #

• 性能层面：ordered: true会按顺序插入文档，相比ordered: false的并行插入，在文档量极大时会有轻微性能损耗，但这种损耗是为了满足事务原子性的必要权衡。若业务对插入性能要求极高且可放弃事务保障，才考虑不使用session+ordered: false的组合，但会失去事务的原子性支持。
• 错误处理层面：设置ordered: true后，批量插入中若某条文档失败，后续文档会停止插入，且事务会回滚所有已插入的内容；而无事务的ordered: false模式下，单条失败不会影响其他文档插入。在事务场景下，这种“失败即全回滚”的逻辑完全符合事务原子性要求，是合理的错误处理行为。

内容的提问来源于stack exchange，提问作者Leo_code