MongoClient.startSession失败主因是云环境连接治理破坏Session状态，需确保连接直连主节点、驱动启用Session支持、禁用空闲回收、升级驱动并验证完整事务流程。
事务报错提示 MongoClient.startSession 失败或 session is not valid
云环境里启动事务前调用 startSession 就失败，基本不是你代码写错了，而是底层连接池或驱动没拿到可用的 Session 支持。MongoDB 事务依赖客户端 Session（ClientSession），而 Session 的生命周期必须由驱动与服务器协同维持——云服务商若在连接层做了连接复用、代理中转或 LB 会话剥离，Session 就容易被“截断”或“重置”。阿里云 MongoDB（如副本集版）、腾讯云 TDMQ for MongoDB、华为云 DDS 都曾出现过这类问题，尤其在开启连接池自动回收或使用短连接模式时。
实操建议：
- 确认云实例版本 ≥ 4.0（事务最低要求），且部署架构为副本集或分片集群（单节点不支持事务）
- 检查驱动是否显式启用 Session 支持：Java 驱动需传
clientSettings.withApplicationName(...)并确保未禁用maxIdleTimeMS；Node.js 驱动要避免在connect()后手动关闭client再重建 - 禁用云控制台里的“连接池自动释放”类开关（如阿里云 DTS 或某些管控后台的“空闲连接回收”选项），这类功能常误杀活跃 Session
云数据库返回 CommandNotFound: 'startSession' 或 not master
这说明请求根本没落到主节点，或者中间代理把 startSession 命令过滤/改写了。云平台常用四层 LB（如 SLB、CLB）做流量分发，但 Session 初始化命令必须直连 Primary，不能走轮询或哈希路由。如果连接字符串里填的是集群 VIP 或只读地址（比如 xxx-readonly.mongodb.rds.aliyuncs.com），事务必然失败。
实操建议：
- 连接字符串必须指向主节点真实地址（阿里云控制台“连接信息”页签下的“主节点连接地址”，不是“集群地址”）
- 禁用驱动的
readPreference=secondary全局设置，事务期间所有操作必须走 Primary - 用
mongosh直连主节点，执行db.runCommand({isMaster:1})确认返回中ismaster:true，再试session = db.getMongo().startSession()
事务提交时抛 InterruptedAtShutdown 或 NotPrimaryNoSecondaryOk
这是典型的 Session 持久性断裂表现：Session 创建时连的是主节点 A，但提交前主节点发生了故障转移（A 下线、B 上位），而你的驱动没及时感知新主，仍往旧地址发 commitTransaction。云平台的自动故障切换速度远快于部分驱动的拓扑刷新周期（尤其老版本驱动），导致 Session “失联”。
实操建议：
- 升级驱动到最新稳定版（如 Java 驱动 ≥ 4.11，Node.js 驱动 ≥ 4.13），它们默认启用
heartbeatFrequencyMS=10000和拓扑变更监听 - 连接字符串中强制加上
?replicaSet=rs0&serverSelectionTimeoutMS=5000，避免卡在选主阶段 - 不要复用
ClientSession跨多个 HTTP 请求或异步任务——它不是线程安全的，也不该长期 hold 住
Spring Boot + MongoDB 事务不生效，日志显示 No transaction in progress
Spring Data MongoDB 默认不开启事务支持，即使你写了 @Transactional，底层也不会自动绑定 ClientSession。更隐蔽的是：若你用的是 MongoTemplate 手动开事务，但 MongoClient 是通过云平台提供的连接池 Bean 注入的，而该 Bean 缺少 enableSession 配置，Session 就是空壳。
实操建议：
- 确认
application.yml中已配置spring.data.mongodb.uri，且 URI 包含&minPoolSize=10&maxPoolSize=100（避免连接池太小导致 Session 分配失败） - 自定义
MongoClientSettingsBean 时，必须调用.applyToClusterSettings(b -> b.applyConnectionString(connString))，否则 Session 上下文丢失 - 使用
@Transactional前，检查是否引入了spring-boot-starter-data-mongodb-reactive—— 它和阻塞式事务不兼容，会静默降级
mongosh 手动模拟一次完整事务流程，而不是只测 CRUD。 
