跳到主要内容
锦木信息 JINMU INFO
MongoDB 博客
MongoDB · 技术文章

多文档事务:
什么时候该用,怎么用对

"MongoDB 支持事务吗?"——支持。从 4.0 起副本集支持多文档事务,4.2 起分片集群也支持。但事务不是免费的:它有运行时长限制、会遇到写冲突、性能代价比单文档写入高。这篇文章讲清楚什么场景需要事务、怎么写才可靠,以及哪些坑要提前避开。

单文档写入天然原子 · 优先考虑
// 订单和明细在同一篇文档里,一次更新全部生效
db.orders.updateOne(
  { _id: "order-1001" },
  { $set: { status: "paid" },
    $push: { logs: { at: new Date(), msg: "支付成功" } } }
)

对单篇文档的写入总是原子的:要么全部生效,要么全不生效,不需要事务。

多文档事务跨文档 · 跨集合
// 扣 A 的余额、加 B 的余额,必须同时成功
session.withTransaction(async () => {
  await accounts.updateOne({ _id: "A" }, { $inc: { balance: -100 } }, { session })
  await accounts.updateOne({ _id: "B" }, { $inc: { balance: 100 } },  { session })
})

涉及多篇文档、多个集合的修改要一起成功或一起回滚时,才需要事务。

示例为说明用的简化代码

01 · 先问需不需要

能用模型解决的,就别用事务

官方文档的建议很明确:事务的可用性不应该取代良好的模式设计。很多看似需要事务的场景,把一起修改的数据放进同一篇文档就解决了。

适合用事务

· 转账:两个账户的余额必须同时变化
· 下单:扣库存、建订单、写流水分属不同集合
· 需要"读到一致快照再决定怎么写"的业务
· 从关系型数据库迁移过来、短期内无法重新建模

通常不需要事务

· 修改的数据都在同一篇文档里(单文档写入本来就原子)
· 只是计数器加减($inc 本身原子)
· 能接受短暂不一致、由后台任务补齐的数据
· 批量导入、数据清洗这类大批量操作

02 · 怎么写

用 withTransaction,让驱动替你重试

事务必须在会话(session)里执行,事务内的每个操作都要带上这个 session。驱动提供两种写法:手动调用开始、提交、中止的 Core API,和自动处理重试的 Callback API。推荐用 Callback API:withTransaction。

Node.js 驱动:下单时扣库存并创建订单
const session = client.startSession()
try {
  await session.withTransaction(async () => {
    const r = await db.collection("inventory").updateOne(
      { sku: "A1", qty: { $gte: 2 } },
      { $inc: { qty: -2 } },
      { session }
    )
    if (r.modifiedCount === 0) throw new Error("库存不足")  // 抛错即回滚

    await db.collection("orders").insertOne(
      { sku: "A1", qty: 2, status: "created" },
      { session }
    )
  }, {
    readConcern:  { level: "snapshot" },
    writeConcern: { w: "majority" }
  })
} finally {
  await session.endSession()
}
为什么推荐 withTransaction

它会自动重试

事务可能因为写冲突、主节点切换等临时原因失败,错误会带上 TransientTransactionError 标签,这时整个事务可以重来;提交时网络断开、不确定是否提交成功,会带上 UnknownTransactionCommitResult,这时可以重试提交。withTransaction 把这两种重试都处理好了,手写 Core API 则要自己实现。

读写关注

snapshot 读 + majority 写

事务内用 snapshot 读关注,读到的是同一时刻的一致快照;提交用 majority 写关注,确保提交结果已复制到多数节点,主节点切换后也不会丢。读偏好必须是 primary。

注意

回调函数可能被执行不止一次(重试时会重新运行),所以回调里只放数据库操作,不要在里面发短信、调第三方接口这类不能重复执行的动作,等事务提交成功之后再做。

03 · 限制与代价

这几个默认值,上线前要知道

以下内容整理自官方文档的生产环境注意事项。

项目默认行为对你的影响
运行时长transactionLifetimeLimitSeconds = 60事务从开始到提交要在 1 分钟内完成,超时会被自动中止。事务里别放慢查询和外部调用
等锁时间maxTransactionLockRequestTimeoutMillis = 5事务最多等 5 毫秒获取锁,拿不到就中止。并发高的热点数据上,事务更容易失败重试
写冲突WriteConflict事务要修改的文档在此期间被事务外的写入改过,事务会因写冲突中止,需要重试
事务大小每条 oplog 记录 ≤ 16MB事务的写入会拆成多条 oplog 记录,没有总大小上限,但每条仍受 16MB 限制;未提交的大事务给 WiredTiger 缓存造成过大压力时也会被中止
部署要求副本集 / 分片集群单机(standalone)不支持事务。本地开发可以起一个单节点副本集
Atlas

MongoDB Atlas 限制修改服务端参数,像 maxTransactionLockRequestTimeoutMillis 这类参数需要联系 Atlas 支持调整。

04 · 最佳实践

小、短、快:让事务尽量少失败

事务持有锁的时间越长、涉及的文档越多,和其他写入冲突的概率就越大。

保持小

只放必须一起成功的操作

能放在事务外面的查询、计算都提前做完,事务里只留真正需要原子性的几次写入。批量修改大量文档时拆成多个小事务。

保持快

事务里的查询要走索引

事务内的每个操作都要有合适的索引。一个全表扫描就可能让事务逼近 60 秒的上限,同时长时间持有锁。

准备失败

重试要有上限

热点数据(比如秒杀商品的库存)上事务频繁冲突时,无限重试只会雪上加霜。设置重试次数上限,超出后返回"请稍后再试"。

❌ 事务里调用外部服务
session.withTransaction(async () => {
  await orders.insertOne(order, { session })
  await paymentApi.charge(order)   // 慢,且重试时会重复扣款
  await inventory.updateOne(…, { session })
})
✅ 外部调用放在事务之外
const paid = await paymentApi.charge(order)   // 先完成支付
session.withTransaction(async () => {
  await orders.insertOne({ ...order, paymentId: paid.id }, { session })
  await inventory.updateOne(…, { session })
})
05 · 上线前对一遍

事务检查清单

设计

先确认真的需要事务

1. 能不能把一起修改的数据放进同一篇文档?
2. 能不能接受短暂不一致、由后台补齐?
3. 事务里是否只有必须一起成功的写入?

实现

写法与配置

1. 用 withTransaction,每个操作都传 session
2. 读关注 snapshot、写关注 majority
3. 回调里没有外部调用和不可重复的动作
4. 事务内的查询都能走索引,重试有上限

WAP 提示

事务频繁中止、重试,通常表现为写入延迟升高和慢操作增多。借助 WAP 的监控和诊断分析找出冲突集中的集合与慢操作,再回头检查事务范围和索引,是比较顺手的排查路径。

最后一句

事务是安全网,
不是建模的替代品

先用好单文档原子写;真正需要跨文档一致时,用 withTransaction 写小而快的事务,配合 snapshot 读和 majority 写,并为失败重试做好准备。

聊聊您的数据难题

告诉我们业务现状,资深技术顾问一对一给出选型与实施建议,咨询免费。