MongoDB事务锁问题核心在于识别持锁与等待锁操作,需用db.currentOp()定位长事务和锁等待,谨慎调整maxTransactionLockRequestTimeoutMillis参数,避免在事务中混入网络/IO操作,并理解读操作也受快照机制影响导致WriteConflict。

查 db.currentOp() 看谁在等锁、谁在持锁
锁等待超时(比如 WriteConflict 或长时间阻塞)往往不是“没锁”,而是“锁被占着不放”。直接运行 db.currentOp({ "waitingForLock": true }) 能立刻揪出正在排队的请求;再补一句 db.currentOp({ "secs_running": { "$gt": 30 } }),把运行超 30 秒的操作也拉出来交叉比对。重点关注字段:secs_running、ns(集合名)、client(来源 IP)、lsid(会话 ID)、type(是 op 还是 txn)。如果发现某个 txn 的 state 是 inProgress 且 secs_running > 300,基本就是它卡住了后续所有操作。
调 maxTransactionLockRequestTimeoutMillis 要谨慎
这个参数控制事务内单次锁获取的最长等待时间,默认仅 5 毫秒。盲目调大(比如设成 3000)会让冲突更晚暴露,但不会减少竞争本身,反而可能掩盖热点文档问题。它只适合临时缓解已知低频冲突场景,不能替代设计优化。调整方式有三种:db.adminCommand({ setParameter: 1, maxTransactionLockRequestTimeoutMillis: 3000 })(在线生效)、启动参数 --setParameter maxTransactionLockRequestTimeoutMillis=3000、或配置文件中加 setParameter = maxTransactionLockRequestTimeoutMillis=3000。注意:该值对已持有的锁无效,只影响新锁申请排队行为。
事务里混了网络/IO 就注定要超时
MongoDB 事务生命周期由服务端 transactionLifetimeLimitSeconds 控制(默认 60 秒),计时从第一个操作开始,不是从 startTransaction() 调用起算。如果事务里夹着 HTTP 请求、文件读写、重试逻辑或 sleep,很容易触发 TransactionTooOld 错误。此时客户端 commit 会收到 ConnectionFailure 或 InvalidOperation,看起来像“卡住”,实则是服务端早已清理了上下文。正确做法是:把外部依赖移出事务;必须同步的,改用幂等+最终一致性方案;实在无法拆分,就严格控制事务内操作粒度,并在应用层做 try/catch/finally 确保 abortTransaction() 被调用。
session.commit_transaction(max_commit_time_ms=...) 不是万能解药
max_commit_time_ms 只限制 commit 阶段的服务端执行耗时,单位毫秒,必须作为关键字参数传给 commit_transaction(),不能设在连接配置里。它对事务整体存活时间毫无影响,也不能解决锁竞争本身——如果 commit 时底层还在等一个被长事务霸占的文档锁,该超时还是会触发 MaxTimeMSExpired。常见误区是设了个很大的值(如 30000),结果事务早被 transactionLifetimeLimitSeconds 终止,commit 请求发过去直接断连。真正有效的 commit 保护,是配合合理的事务拆分 + 客户端重试(匹配 "WriteConflict" 字符串)+ 避免单文档高频更新。
事务里最容易被忽略的点,是“读操作也绑定快照”——哪怕只是 findOne() 后再 updateOne(),只要别人改了同一文档,就会触发 WriteConflict。这不是锁等待,是 MVCC 快照校验失败,没法靠调参数绕过,只能靠设计规避。











