必须重试整个事务体而非仅committransaction，因服务端状态未知，重试commit会触发nosuchtransaction；需新建session、设snapshot读关注、写操作幂等。
UnknownTransactionCommitResult 不是网络超时，而是服务端无法确认事务是否提交成功；必须重试整个事务体，不能只重试 commitTransaction()，且所有写操作必须幂等。
为什么不能只重试 commitTransaction()
客户端发出 commit 请求后未收到明确响应，可能原因包括主节点切换、网络分区或连接中断。此时服务端状态未知：事务可能已提交，也可能被丢弃。若直接调用 commitTransaction() 重试，会因事务上下文（txnNumber）失效而报 NoSuchTransaction 或 TransactionTooOld。驱动（PyMongo/Node.js/Rust 等）默认不自动处理该错误，with_transaction() 也不包含它——它只捕获 TransientTransactionError。
重试整个事务体的必要步骤
每次重试都必须视为一次全新事务，而非“续上上次”：
- 立即调用
session.endSession()，防止连接池中 session 泄漏 - 新建
ClientSession，显式调用session.startTransaction() - 读操作必须指定
readConcern: "snapshot"，否则两次读可能看到不一致快照 - 写操作全部改为幂等形式：
updateOne({ _id: orderId }, { $setOnInsert: { status: "pending" }, $set: { updatedAt: new Date() } }, { upsert: true })替代insertOne()；用条件更新替代无保护写入
哪些错误该重试，哪些不该
不是所有事务错误都适合重试：
- 应重试：
TransientTransactionError（可用error.hasErrorLabel("TransientTransactionError")判断）、UnknownTransactionCommitResult、WriteConflict（error.code === 112） - 不可重试：
InvalidNamespace、Unauthorized、DocumentValidationFailure等语义错误，重试只会重复失败 - 注意：MongoDB 4.2+ 中
WriteConflict不再自动带TransientTransactionError标签，需单独检查error.code
生产环境必须检查的底层配置
即使代码逻辑正确，底层配置不匹配也会高频触发该错误：
- 所有分片/副本集成员必须启用
enableMajorityReadConcern=true，否则 prepare 阶段静默失败 - 各分片 MongoDB 小版本号（含补丁号，如 6.0.12 vs 6.0.15）必须完全一致，gitVersion 也须相同
-
writeConcern必须设为{ w: "majority", j: true }；w: 1几乎必然导致UnknownTransactionCommitResult - 副本集投票节点数必须为奇数且 ≥3，否则
"majority"语义失效
最容易被忽略的是：事务内读操作没加 readConcern: "snapshot"，导致重试时读到中间态数据；以及把 ClientSession 存在 request context 外（比如全局变量或静态字段），造成 session 被提前回收或跨请求复用。
