MongoDB事务提交失败时如何实现自动重试？

不能只重试commitTransaction()，必须重试整个事务体且写操作幂等，因为UnknownTransactionCommitResult发生时服务端状态未知，原txnNumber已失效，重试commit会触发NoSuchTransaction；驱动默认不处理该错误，with_transaction()也不覆盖它。

不能只重试 commitTransaction()，必须重试整个事务体，且所有写操作必须幂等。

为什么 UnknownTransactionCommitResult 错误不能只重试 commit

客户端发出 commitTransaction() 后没收到明确响应，不代表服务端没执行——它可能已提交、也可能被丢弃。此时事务上下文（txnNumber）已失效，再调用 commitTransaction() 会触发 NoSuchTransaction 或 TransactionTooOld 错误。

PyMongo、Node.js 驱动等默认不自动处理该错误；with_transaction() 也只捕获 TransientTransactionError，不包含 UnknownTransactionCommitResult。

1. 常见错误现象：OperationFailure: UnknownTransactionCommitResult 紧接着报 NoSuchTransaction
2. 根本原因：主节点切换、网络分区或连接中断导致服务端状态不可知
3. 驱动不会帮你“续上上次”，必须当成全新事务启动

重试整个事务体的实操要点

每次重试都得从头开始：新建会话、开启事务、执行全部读写逻辑。关键不是“怎么重试”，而是“怎么重试才安全”。

1. 立即调用 session.endSession()，防止 session 泄漏到连接池
2. 用 client.startSession() 创建新会话，显式调用 session.startTransaction()
3. 读操作必须设 readConcern: "snapshot"，否则两次重试可能看到不同快照
4. 写操作全部改为幂等形式：用 updateOne({ _id }, { $setOnInsert: {...}, $set: {...} }, { upsert: true }) 替代 insertOne()；用条件更新（如 { status: "pending" }）替代无保护的 $inc

哪些错误该重试，哪些不该

不是所有事务失败都适合重试。盲目重试语义错误只会放大问题。

1. 应重试：TransientTransactionError（可用 error.hasErrorLabel("TransientTransactionError") 判断）、UnknownTransactionCommitResult、WriteConflict（error.code === 112，MongoDB 4.2+ 不再自动带标签，需单独检查）
2. 不可重试：InvalidNamespace、Unauthorized、DocumentValidationFailure 等——这些是代码或权限配置问题，重试无意义

注意：WriteConflict 在 Go / Python / Node.js 驱动中通常不自动重试，需手动包裹在重试循环里。

底层配置不匹配会导致重试频繁失败

即使代码完全正确，以下配置任一不满足，都会让 UnknownTransactionCommitResult 高频出现，重试也救不了：

1. 所有副本集/分片成员必须启用 enableMajorityReadConcern=true（否则 prepare 阶段静默失败）
2. 各分片 MongoDB 小版本号（含补丁号，如 6.0.12 vs 6.0.15）和 gitVersion 必须完全一致
3. writeConcern 必须设为 { w: "majority", j: true }；w: 1 几乎必然触发该错误
4. 副本集投票节点数必须为奇数且 ≥3，否则 "majority" 语义失效

最容易被忽略的是版本一致性——哪怕只是补丁号差一位，事务提交阶段就可能卡在协调节点确认环节，最终超时返回 UnknownTransactionCommitResult。