不能只重试committransaction()，必须重试整个事务体且写操作幂等，因为unknowntransactioncommitresult发生时服务端状态未知，原txnnumber已失效，重试commit会触发nosuchtransaction；驱动默认不处理该错误，with_transaction()也不覆盖它。
不能只重试 commitTransaction()，必须重试整个事务体，且所有写操作必须幂等。
为什么 UnknownTransactionCommitResult 错误不能只重试 commit
客户端发出 commitTransaction() 后没收到明确响应，不代表服务端没执行——它可能已提交、也可能被丢弃。此时事务上下文（txnNumber）已失效，再调用 commitTransaction() 会触发 NoSuchTransaction 或 TransactionTooOld 错误。
PyMongo、Node.js 驱动等默认不自动处理该错误；with_transaction() 也只捕获 TransientTransactionError，不包含 UnknownTransactionCommitResult。
- 常见错误现象：
OperationFailure: UnknownTransactionCommitResult紧接着报NoSuchTransaction - 根本原因：主节点切换、网络分区或连接中断导致服务端状态不可知
- 驱动不会帮你“续上上次”，必须当成全新事务启动
重试整个事务体的实操要点
每次重试都得从头开始：新建会话、开启事务、执行全部读写逻辑。关键不是“怎么重试”，而是“怎么重试才安全”。
- 立即调用
session.endSession()，防止 session 泄漏到连接池 - 用
client.startSession()创建新会话，显式调用session.startTransaction() - 读操作必须设
readConcern: "snapshot"，否则两次重试可能看到不同快照 - 写操作全部改为幂等形式：用
updateOne({ _id }, { $setOnInsert: {...}, $set: {...} }, { upsert: true })替代insertOne()；用条件更新（如{ status: "pending" }）替代无保护的$inc
哪些错误该重试，哪些不该
不是所有事务失败都适合重试。盲目重试语义错误只会放大问题。
- 应重试：
TransientTransactionError（可用error.hasErrorLabel("TransientTransactionError")判断）、UnknownTransactionCommitResult、WriteConflict（error.code === 112，MongoDB 4.2+ 不再自动带标签，需单独检查） - 不可重试：
InvalidNamespace、Unauthorized、DocumentValidationFailure等——这些是代码或权限配置问题，重试无意义
注意：WriteConflict 在 Go / Python / Node.js 驱动中通常不自动重试，需手动包裹在重试循环里。
底层配置不匹配会导致重试频繁失败
即使代码完全正确，以下配置任一不满足，都会让 UnknownTransactionCommitResult 高频出现，重试也救不了：
- 所有副本集/分片成员必须启用
enableMajorityReadConcern=true（否则 prepare 阶段静默失败） - 各分片 MongoDB 小版本号（含补丁号，如
6.0.12vs6.0.15）和gitVersion必须完全一致 -
writeConcern必须设为{ w: "majority", j: true }；w: 1几乎必然触发该错误 - 副本集投票节点数必须为奇数且 ≥3，否则
"majority"语义失效
最容易被忽略的是版本一致性——哪怕只是补丁号差一位，事务提交阶段就可能卡在协调节点确认环节，最终超时返回 UnknownTransactionCommitResult。
