MongoDB 4.0 事务必须在副本集模式下启用,单节点不支持;需显式绑定同一 ClientSession 并手动提交/回滚;不支持跨库操作(除非分片集群);超时、网络中断或非法操作会触发隐式回滚。

事务必须在副本集模式下开启
MongoDB 4.0 的事务不支持单节点部署,mongod 必须以副本集(replica set)方式启动,哪怕只是本地测试用的 rs0。直接运行单机 mongod --port 27017 后执行事务,会报错:Transaction numbers are only allowed on a replica set member or mongos。启动时得加 --replSet rs0,再连上执行 rs.initiate() —— 这步漏掉,后面所有 session.startTransaction() 都会失败。
下单操作需显式绑定会话并手动控制提交/回滚
MongoDB 事务不是自动的,每个操作必须挂载到同一个 ClientSession 实例上,且必须显式调用 commitTransaction() 或 abortTransaction()。常见错误是:只写了 session.startTransaction(),但没在 try/catch 里兜住异常,导致出错后既没提交也没回滚,会话卡在「open」状态,后续再用该 session 就抛 TransactionAlreadyCommitted 或 TransactionAlreadyAborted。
典型电商下单原子化逻辑包括:
- 扣减商品库存(
inventory.updateOne(),检查stock >= orderQty) - 插入订单文档(
orders.insertOne()) - 记录用户积分变动(
pointsLog.insertOne()) - 更新用户最近下单时间(
users.updateOne())
全部操作都要传入同一 session 参数,例如:collection.updateOne(filter, update, { session })。漏传 session 的操作不在事务内,无法回滚。
事务内不能跨数据库操作(除非用 mongos)
单机副本集模式下,MongoDB 4.0 不允许一个事务跨多个数据库。比如把 inventory 放在 shop 库、orders 放在 trade 库,然后在一个 session 里同时操作二者——会直接报错:Cannot use a session that has an active transaction in a different database。解决办法只有两个:
- 把相关集合收拢到同一个数据库(如全放在
ecommerce下),这是最常用也最稳妥的做法 - 升级到分片集群 +
mongos,由路由节点协调跨库事务(但 4.0 对跨库事务支持仍有限,生产环境慎用)
另外注意:事务中所有读操作默认使用 snapshot 隔离级别,但写操作不会自动触发 readConcern: "snapshot",需要显式指定(尤其做库存预检时)。
回滚触发条件不止是代码抛异常
事务回滚不仅发生在 catch 块里调用 abortTransaction(),以下情况也会隐式回滚:
- 会话空闲超时(默认 60 秒),
session被服务端自动清理 - 客户端进程崩溃或网络断开,未发出
commit或abort - 事务内执行了不支持的操作(如
createIndex()、dropDatabase()),驱动会立即终止事务
所以业务上要做两件事:一是设置合理的 maxTransactionTimeMS(比如下单逻辑设为 5000),避免长事务拖垮系统;二是关键步骤后加校验(如扣库存后立刻 findOne() 确认结果),别等最后才发现数据不一致。
真正难处理的是部分写成功后网络中断——这时服务端已执行但客户端不知道结果,需要配合幂等设计(比如用唯一 orderNo 防重)和异步对账补偿,事务本身解决不了这个问题。











