ClientSession.close()不能随便调用，因为一旦关闭会话状态立即变为CLOSED，后续所有操作（包括startTransaction、commitTransaction、find等）均抛IllegalStateException；必须严格遵循“事务结束才close”原则，并置于finally块中确保执行。
ClientSession 已关闭错误，基本都是提前调用了 close() 或会话超时未刷新导致的，不是连接池问题，而是生命周期管理失控。
为什么 ClientSession.close() 不能随便调用
Java 驱动中 ClientSession 是轻量级会话对象，但它的生命周期和底层网络会话强绑定。一旦调用 close()，会话状态立即变为 CLOSED，后续任何操作（包括 startTransaction()、commitTransaction()、甚至 find()）都会抛 IllegalStateException: Session is closed。
- 常见错误：在 try 块里执行完 CRUD 就立刻
session.close()，没等事务提交或回滚 - 更隐蔽的错误：把 session 当作可复用资源，在多个方法间传递并多次 close
- 注意：
ClientSession不是线程安全的，也不支持重用 —— 即使没 close，跨线程使用也会触发InvalidSessionException
localLogicalSessionTimeoutMinutes 超时后 session 自动失效
MongoDB 服务端默认 30 分钟关闭空闲会话（由 localLogicalSessionTimeoutMinutes 控制），驱动不会自动续期。如果一次事务耗时接近或超过这个阈值，或者中间有长延迟（比如同步调用外部 API），session 就可能被服务端静默终止。
- 现象：
commitTransaction()抛MongoCommandException，错误码为40521（SessionNotFound）或262（InvalidNamespace类似误报） - 解决方式不是加长超时（服务端配置受限），而是主动刷新：
session.refresh()可重置服务端计时器，建议在长流程关键节点调用 - 不要依赖
session.isClosed()判断 —— 它只反映本地状态，无法感知服务端是否已 kill 该 session
事务未结束就让 session 离开作用域
最典型的“已关闭”其实是伪错误：session 对象还在，但事务已异常终止，驱动内部将 session 标记为不可再用，此时再调用任何带 session 的操作，都会报 “session is closed” 或 “session is in transaction”，看似矛盾实则逻辑闭环。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
- 根本原因：没在
finally块里配对调用commitTransaction()或abortTransaction() - 尤其注意：如果
commitTransaction()抛异常（如写冲突、网络闪断），必须紧接着abortTransaction()，否则 session 卡在 OPEN 状态，下次 reuse 就报错 - 正确模式：
try {
session.startTransaction();
collection.insertOne(session, doc1);
collection.updateOne(session, filter, update);
session.commitTransaction(); // ← 成功才到这里
} catch (RuntimeException e) {
session.abortTransaction(); // ← 异常时强制终结事务
throw e;
} finally {
session.close(); // ← 必须放 finally，且仅在此处 close
}
异步场景下 session 被提前释放
在 CompletableFuture、ForkJoinPool 或 Spring WebFlux 中，主线程创建的 ClientSession 一旦离开当前线程上下文，就不再有效。哪怕只是读取 session.getClusterTime()，也可能触发 IllegalStateException: Session is not associated with any cluster。
- 根本限制：MongoDB Java 驱动的
ClientSession绑定到创建它的线程和 MongoClient 实例，无法序列化或跨线程迁移 - 可行方案只有两个：要么把整个事务逻辑留在同一线程内完成；要么在异步回调中新建 session（但无法保证因果一致性）
- Spring @Transactional 完全不兼容原生
ClientSession—— 它管理的是 Hibernate Session，不是 MongoDB 的逻辑会话
真正麻烦的不是“怎么关 session”，而是“什么时候它已经不该再被用了”。驱动不报错的那一刻，往往才是问题开始的地方。
