document.writeln('');
MongoClient.startSession失敗主因是云環(huán)境連接治理破壞Session狀態(tài),需確保連接直連主節(jié)點(diǎn)、驅(qū)動啟用Session支持、禁用空閑回收、升級驅(qū)動并驗(yàn)證完整事務(wù)流程。

MongoClient.startSession 失敗或 session is not valid云環(huán)境里啟動事務(wù)前調(diào)用 startSession 就失敗,基本不是你代碼寫錯了,而是底層連接池或驅(qū)動沒拿到可用的 Session 支持。MongoDB 事務(wù)依賴客戶端 Session(ClientSession),而 Session 的生命周期必須由驅(qū)動與服務(wù)器協(xié)同維持——云服務(wù)商若在連接層做了連接復(fù)用、代理中轉(zhuǎn)或 LB 會話剝離,Session 就容易被“截?cái)唷被颉爸刂谩薄0⒗镌?MongoDB(如副本集版)、騰訊云 TDMQ for MongoDB、華為云 DDS 都曾出現(xiàn)過這類問題,尤其在開啟連接池自動回收或使用短連接模式時。
實(shí)操建議:
clientSettings.withApplicationName(...) 并確保未禁用 maxIdleTimeMS;Node.js 驅(qū)動要避免在 connect() 后手動關(guān)閉 client 再重建CommandNotFound: startSession 或 not master這說明請求根本沒落到主節(jié)點(diǎn),或者中間代理把 startSession 命令過濾/改寫了。云平臺常用四層 LB(如 SLB、CLB)做流量分發(fā),但 Session 初始化命令必須直連 Primary,不能走輪詢或哈希路由。如果連接字符串里填的是集群 VIP 或只讀地址(比如 xxx-readonly.mongodb.rds.aliyuncs.com),事務(wù)必然失敗。
實(shí)操建議:
readPreference=secondary 全局設(shè)置,事務(wù)期間所有操作必須走 Primarymongosh 直連主節(jié)點(diǎn),執(zhí)行 db.runCommand({isMaster:1}) 確認(rèn)返回中 ismaster:true,再試 session = db.getMongo().startSession()InterruptedAtShutdown 或 NotPrimaryNoSecondaryOk這是典型的 Session 持久性斷裂表現(xiàn):Session 創(chuàng)建時連的是主節(jié)點(diǎn) A,但提交前主節(jié)點(diǎn)發(fā)生了故障轉(zhuǎn)移(A 下線、B 上位),而你的驅(qū)動沒及時感知新主,仍往舊地址發(fā) commitTransaction。云平臺的自動故障切換速度遠(yuǎn)快于部分驅(qū)動的拓?fù)渌⑿轮芷冢ㄓ绕淅习姹掘?qū)動),導(dǎo)致 Session “失聯(lián)”。
實(shí)操建議:
heartbeatFrequencyMS=10000 和拓?fù)渥兏O(jiān)聽?replicaSet=rs0&serverSelectionTimeoutMS=5000,避免卡在選主階段ClientSession 跨多個 HTTP 請求或異步任務(wù)——它不是線程安全的,也不該長期 hold 住No transaction in progressSpring Data MongoDB 默認(rèn)不開啟事務(wù)支持,即使你寫了 @Transactional,底層也不會自動綁定 ClientSession。更隱蔽的是:若你用的是 MongoTemplate 手動開事務(wù),但 MongoClient 是通過云平臺提供的連接池 Bean 注入的,而該 Bean 缺少 enableSession 配置,Session 就是空殼。
實(shí)操建議:
application.yml 中已配置 spring.data.mongodb.uri,且 URI 包含 &minPoolSize=10&maxPoolSize=100(避免連接池太小導(dǎo)致 Session 分配失敗)MongoClientSettings Bean 時,必須調(diào)用 .applyToClusterSettings(b -> b.applyConnectionString(connString)),否則 Session 上下文丟失@Transactional 前,檢查是否引入了 spring-boot-starter-data-mongodb-reactive —— 它和阻塞式事務(wù)不兼容,會靜默降級mongosh 手動模擬一次完整事務(wù)流程,而不是只測 CRUD。