logicalSessionTimeoutMinutes配置过低是导致集群级Session溢出和性能崩盘的直接原因，它定义服务端自动清理空闲clientSession的超时时间，若设为30分钟而业务存在长连接低频操作，将引发mongos与mongod资源堆积、WiredTiger错误及节点崩溃。
logicalSessionTimeoutMinutes 配置过低，是导致集群级 Session 溢出和性能崩盘的直接原因。它不是“可选优化项”，而是分片集群中 mongos 和 mongod 节点必须对齐的基础安全水位线。
logicalSessionTimeoutMinutes 是什么，为什么它会触发雪崩
该参数定义了 MongoDB 服务端自动清理空闲 clientSession 的超时时间（单位：分钟）。一旦客户端未主动 endSession()，且连接断开或心跳中断，服务端会在该时限后回收 session 资源。但若配置值太小（如默认 30 分钟），而业务存在长连接+低频操作模式（比如 Java 应用复用连接池但不显式结束 session），就会造成：
— mongos 缓存大量已失效但未超时的 session 元数据
— mongod 后端持续维护这些 session 的上下文、事务状态、oplog 位置跟踪等
— 最终触发 WiredTiger error (-31802) out of sessions 类错误，从节点 crash，写入阻塞，查询排队
如何确认当前 session 压力已逼近阈值
在任意 mongos 或 mongod 节点上执行：db.runCommand({serverStatus: 1}).logicalSessionRecordCache
重点关注以下字段：
-
numActiveSessions：当前活跃 session 数（含未超时但空闲的） -
numIdleSessions：空闲但尚未被清理的 session 数 -
numTimedOutSessions：上一周期内因超时被清理的数量（突增说明配置过紧）
若 numIdleSessions 持续 > 5000，且 numActiveSessions 占总连接数 70% 以上，即为高风险信号。
使用 Playwright 为 jimeng.jianying.com 管理浏览器会话，导入 cookies/localStorage 以自动化视频生成工作流，支持图片上传等功能
调整 logicalSessionTimeoutMinutes 的实操要点
该值不能盲目调大，需结合客户端行为与集群负载综合设定：
- 先检查客户端是否调用
session.endSession()—— PyMongo 4.0+ 默认在with client.start_session() as s:退出时自动调用；旧版本或手动管理 session 的代码必须显式调用 - 确认连接池最大空闲时间（如 Java 的
maxConnectionLifeTimeMS、maxConnectionIdleTimeMS）是否小于当前logicalSessionTimeoutMinutes，否则 session 会被提前“悬空” - 生产环境建议设为
60（1 小时），而非默认30；若存在定时任务类长周期作业，可设为120，但需同步检查wiredTiger.cache中bytes currently in the cache是否持续 >95% - 修改命令（需在所有
mongos和mongod节点执行）：db.adminCommand({setParameter: 1, logicalSessionTimeoutMinutes: 60}) - 注意：该参数无法热加载到正在运行的 session，只影响新建立的 session；已有悬空 session 需等待超时或重启节点释放
配套必须做的三件事，否则单调 timeout 无效
仅改 logicalSessionTimeoutMinutes 是治标不治本：
- 在所有事务块外层强制加
try/finally，finally中调用session.abortTransaction()（即使已 commit 也无副作用） - 禁用客户端连接池的“连接泄漏容忍”行为：例如 PyMongo 的
maxIdleTimeMS必须 ≤logicalSessionTimeoutMinutes × 60000 − 5000（预留 5 秒缓冲） - 监控指标必须接入
logicalSessionRecordCache.numIdleSessions和connections.current的比值，设置告警阈值 >0.6
Session 不是连接，也不是 TCP socket；它是跨组件、跨进程、带状态的逻辑资源。它的生命周期失控，比连接耗尽更隐蔽，也更致命。
