多文档事务:
什么时候该用,怎么用对
"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 }) })
涉及多篇文档、多个集合的修改要一起成功或一起回滚时,才需要事务。
示例为说明用的简化代码
能用模型解决的,就别用事务
官方文档的建议很明确:事务的可用性不应该取代良好的模式设计。很多看似需要事务的场景,把一起修改的数据放进同一篇文档就解决了。
适合用事务
· 转账:两个账户的余额必须同时变化
· 下单:扣库存、建订单、写流水分属不同集合
· 需要"读到一致快照再决定怎么写"的业务
· 从关系型数据库迁移过来、短期内无法重新建模
通常不需要事务
· 修改的数据都在同一篇文档里(单文档写入本来就原子)
· 只是计数器加减($inc 本身原子)
· 能接受短暂不一致、由后台任务补齐的数据
· 批量导入、数据清洗这类大批量操作
用 withTransaction,让驱动替你重试
事务必须在会话(session)里执行,事务内的每个操作都要带上这个 session。驱动提供两种写法:手动调用开始、提交、中止的 Core API,和自动处理重试的 Callback API。推荐用 Callback API:withTransaction。
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() }
它会自动重试
事务可能因为写冲突、主节点切换等临时原因失败,错误会带上 TransientTransactionError 标签,这时整个事务可以重来;提交时网络断开、不确定是否提交成功,会带上 UnknownTransactionCommitResult,这时可以重试提交。withTransaction 把这两种重试都处理好了,手写 Core API 则要自己实现。
snapshot 读 + majority 写
事务内用 snapshot 读关注,读到的是同一时刻的一致快照;提交用 majority 写关注,确保提交结果已复制到多数节点,主节点切换后也不会丢。读偏好必须是 primary。
回调函数可能被执行不止一次(重试时会重新运行),所以回调里只放数据库操作,不要在里面发短信、调第三方接口这类不能重复执行的动作,等事务提交成功之后再做。
这几个默认值,上线前要知道
以下内容整理自官方文档的生产环境注意事项。
MongoDB Atlas 限制修改服务端参数,像 maxTransactionLockRequestTimeoutMillis 这类参数需要联系 Atlas 支持调整。
小、短、快:让事务尽量少失败
事务持有锁的时间越长、涉及的文档越多,和其他写入冲突的概率就越大。
只放必须一起成功的操作
能放在事务外面的查询、计算都提前做完,事务里只留真正需要原子性的几次写入。批量修改大量文档时拆成多个小事务。
事务里的查询要走索引
事务内的每个操作都要有合适的索引。一个全表扫描就可能让事务逼近 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 }) })
事务检查清单
先确认真的需要事务
1. 能不能把一起修改的数据放进同一篇文档?
2. 能不能接受短暂不一致、由后台补齐?
3. 事务里是否只有必须一起成功的写入?
写法与配置
1. 用 withTransaction,每个操作都传 session
2. 读关注 snapshot、写关注 majority
3. 回调里没有外部调用和不可重复的动作
4. 事务内的查询都能走索引,重试有上限
事务频繁中止、重试,通常表现为写入延迟升高和慢操作增多。借助 WAP 的监控和诊断分析找出冲突集中的集合与慢操作,再回头检查事务范围和索引,是比较顺手的排查路径。
