NestJS中Mongoose事务必须显式管理ClientSession，因MongoDB不支持全局事务拦截且Nest无@Transactional装饰器；所有操作（如save、findOne、aggregate写操作）均需手动传入同一session，跨Model需各自调用.session(session)，推荐封装带自动abort/end的工具函数，并通过参数透传session而非DI注入。
在 NestJS 中用 Mongoose 实现 MongoDB 事务，必须手动管理 session，不能靠装饰器或自动注入“事务管道”——MongoDB 本身不支持全局事务拦截，NestJS 也没有内置的 @Transactional 装饰器。
为什么 session.startTransaction() 必须显式传入每个操作
Mongoose 的事务依赖于单个 ClientSession 实例，所有参与事务的 Model 操作（save()、deleteOne()、updateMany() 等）都必须显式传入同一个 session 参数。漏传任意一个，该操作就脱离事务上下文，无法回滚。
-
Model.findOne({}).session(session)是必需的，不是可选的 - 聚合管道（
aggregate()）若含写操作（如$merge或$out），也得加.session(session) - 跨 Model 操作时，每个 Model 都要调用自己的
session()方法，不存在“共享 session 上下文”的自动绑定
如何在 NestJS Service 中安全启动和结束事务
推荐封装一个带错误捕获与自动清理的工具函数，避免手写 try/catch/finally 重复逻辑。不要在 Controller 层直接开事务，应在 Service 方法内闭环处理。
- 使用
await mongoose.connection.startSession()获取 session，而非new ClientSession() - 务必在
catch块中调用session.abortTransaction()，否则可能阻塞连接池 - 在
finally中调用session.endSession()，无论成功失败都要释放资源 - 示例片段：
async performWithTransaction(cb: (session: ClientSession) => Promise<any>) { const session = await this.connection.startSession(); try { await session.withTransaction(() => cb(session)); } catch (err) { await session.abortTransaction(); throw err; } finally { await session.endSession(); } }
哪些 Mongoose 操作默认不参与事务？怎么修复
以下操作默认绕过事务，除非你显式干预：
-
Model.insertMany()：需传{ session }选项，如users.insertMany(docs, { session }) -
Model.bulkWrite()：每个子操作（insertOne、updateOne）的options字段里单独加{ session } -
Model.deleteMany()和Model.updateMany()：必须调用.session(session)链式方法，不能只靠参数 - Query 中的
lean()、select()等读操作虽不改数据，但若在事务中执行，仍应传session以保证读隔离级别（如 snapshot）
嵌套 Service 调用时 session 怎么透传
不能依赖 DI 容器注入 session（它不是单例，也不跨请求生命周期），必须通过函数参数逐层传递。NestJS 的作用域（@Injectable({ scope: Scope.REQUEST })）对 session 无效——session 是运行时对象，不是服务实例。
- 避免在构造函数里存 session，会导致状态污染和内存泄漏
- 把 session 当作“上下文凭证”，像 token 一样作为参数传给所有需要它的内部方法
- 如果多个 Service 协同完成一个业务动作，统一由最外层 Service 启动事务，并把
session作为参数透传给被调用方 - 切勿在 Repository 层缓存或复用 session：每次事务必须是全新
ClientSession实例
事务的边界必须由业务语义决定，而不是技术便利性；session 泄漏、漏传、重用是线上事务失效最常见的三个原因。
