驱动版本不匹配是事务行为差异的主因，Java Driver 4.10+ 默认启用 commitTransaction 幂等重试，而4.9-遇网络抖动可能静默丢弃响应致状态悬空；Spring Boot 3.1+虽默认拉取4.11.x驱动，但显式声明旧版mongo-java-driver会导致隐式降级，引发跨分片事务失效；Node.js Driver 6.3+要求事务session独占连接，maxPoolSize过小会触发超时而非回滚；服务端与驱动补丁号须严格匹配兼容矩阵，否则prepare阶段可能静默失败。
驱动版本不匹配是事务行为差异的主因，不是 MongoDB 服务端配置问题
Java Driver 4.10+ 与 4.9- 在事务提交逻辑上的关键区别
Java Driver 4.10 起默认启用 commitTransaction 的幂等重试机制，而 4.9 及更早版本在遇到网络抖动时可能静默丢弃 commit 响应，导致事务状态悬空（服务端已提交，客户端认为失败）。这种差异在分片集群中尤其明显，因为 mongos 到 shard 的 RPC 链路更长。
- 现象：同一段事务代码，在本地单节点 MongoDB 上稳定，在分片集群中偶发
UnknownTransactionCommitResult - 验证方式：抓包看客户端是否发出
commitTransaction命令，再查对应 shard 的日志是否有transaction committed记录 - 解决路径：升级到
mongodb-driver-sync4.11.2 或更高（官方已修复 4.10.x 中部分重试边界条件）
Spring Boot Starter Data MongoDB 的隐式驱动绑定陷阱
Spring Boot 3.1+ 默认拉取 mongodb-driver-sync 4.11.x，但若项目里显式声明了旧版 mongo-java-driver（如 3.12.10），Maven 会按就近原则保留旧版，导致 MongoTemplate 底层实际使用的是不支持跨分片事务的 Legacy Driver。
- 错误现象：
@Transactional注解失效、session.startTransaction()报CommandFailed: transaction numbers are only allowed on a session with causal consistency - 检查命令：
mvn dependency:tree | grep mongo，确认最终解析出的 driver artifactId 是mongodb-driver-sync而非mongo-java-driver - 强制对齐：在
pom.xml中用<properties><mongodb.driver.version>4.11.2</mongodb.driver.version></properties>统一控制
Node.js Driver 的 maxPoolSize 与事务 session 生命周期冲突
Node.js Driver 6.3+ 要求每个事务 session 必须独占一个连接，若 maxPoolSize 设置过小（如 5），高并发事务请求会排队等待连接，超时后抛 MaxTimeMSExpired，而非预期的事务回滚。
- 典型表现：压测时前几笔事务成功，后续大量
TransactionUseAfterCommitOrAbort或连接超时 - 安全阈值：分片集群建议
maxPoolSize >= 并发事务峰值 × 2（每个事务至少需 1 连接 + 1 预留连接防阻塞） - 验证方式：连接 mongos 后执行
db.currentOp({ "secs_running": { "$gt": 1 } })，观察是否有大量commitTransaction操作卡在awaitingLock
最容易被忽略的是驱动与服务端版本的“兼容窗口”——比如 MongoDB 6.0.20 服务端要求 Java Driver 至少为 4.10.2，低于此版本即使能连上，事务 prepare 阶段也可能因 txnNumber 编码格式不兼容而静默失败。不要只看大版本号，补丁号必须落在官方兼容矩阵内。
