UnknownTransactionCommitResult错误必须重试整个事务体而非仅commitTransaction，因驱动不自动处理该错误，需手动实现带退避的重试循环并最终查库确认状态。
遇到 UnknownTransactionCommitResult 错误时，必须重试整个事务体，而不是只重试 commitTransaction()；驱动不会自动处理它，需手动实现带退避的重试循环。
为什么 UnknownTransactionCommitResult 不能靠驱动自动恢复
这个错误表示客户端发出了 commit 请求，但没收到服务器明确响应——可能是网络中断、请求超时、或主节点在提交瞬间切换。MongoDB 驱动（PyMongo、Node.js、Rust 等）默认不自动重试该错误，因为无法确定服务端是否已提交成功（“已提交”和“未提交”都可能）。盲目重试 commitTransaction() 会触发 NoSuchTransaction，而忽略它又可能导致数据不一致。
关键点：
-
UnknownTransactionCommitResult不在with_transaction()的默认重试范围内（它只处理TransientTransactionError） - 服务端 MongoDB 6.2+ 也不会对它自动重试（文档明确说明）
- 你必须自己判断：是重试整个事务，还是走补偿/幂等查证流程
重试整个事务体的实操要点
每次重试都要新建 ClientSession 并重新执行全部读写逻辑，不是“接着上次没 commit 的 session 继续”。否则会报 InvalidSession 或 NoSuchTransaction。
具体步骤：
- 捕获到
UnknownTransactionCommitResult后，立即调用session.endSession()（尤其在连接池场景下防泄漏） - 新建
ClientSession，显式调用session.startTransaction() - 重新执行所有业务操作（包括读取），且读操作必须加
readConcern: "snapshot"，否则两次读结果可能不一致 - 写操作必须幂等：用
updateOne(..., { upsert: true })替代insertOne()，用$setOnInsert控制初始字段
要不要加指数退避？加多少次？
要加，且建议 2～3 次。这不是可选项——第一次失败后立刻重试，大概率撞上还没完成的主从切换或网络抖动。
典型退避策略：
- 第 1 次失败后等待
100ms - 第 2 次失败后等待
300ms - 第 3 次失败后直接抛出原始错误（含
errorLabels），不再继续
注意：UnknownTransactionCommitResult 不在官方标记的 TransientTransactionError 列表里，所以不能靠 errorLabels.includes("TransientTransactionError") 判断——得靠错误类型名精确匹配，不同驱动返回的 error name 不同（如 PyMongo 是 UnknownTransactionCommitResult，Node.js 驱动是 UnknownTransactionCommitResult，Rust 驱动也是同名）。
比重试更关键的是：怎么确认最终状态
重试最多 3 次仍失败，不能直接放弃。此时应启动「最终一致性验证」：
- 用独立会话查询关键文档的最终状态（比如订单是否已创建、库存是否已扣减）
- 若状态符合预期，说明上次 commit 实际成功了，只是响应丢了 —— 此时可安全结束
- 若状态缺失或异常，则按业务规则触发补偿（如发消息通知人工介入、回滚上游状态）
这一步常被跳过，但恰恰是避免数据错乱的最后一道防线。MongoDB 不提供“两阶段提交”的外部协调器，最终状态必须由应用层闭环确认。
