Rust驱动中事务需显式传ClientSession实例给每个操作，否则不生效；跨Client使用会报错；异步中应避免move可变引用，失败后须幂等重试。
必须用 ClientSession 显式传入每个操作，否则事务不生效 —— 这是 90% 初学者踩坑的根源。
为什么 start_transaction() 单独调用没用
事务不是“开启即生效”的全局开关。Rust 驱动要求你把 ClientSession 实例显式传给每一个 insert_one()、find_one_and_update() 等操作，否则这些操作默认走普通会话，完全绕过事务上下文。
- 错误写法：
session.start_transaction().await?;后直接调用collection.insert_one(...).await?→ 该插入不在事务中 - 正确写法：
collection.insert_one(...).session(&mut session).await?，每个操作都带.session() - 事务状态只在
session实例内部维护，Client或Collection本身不持有事务上下文
ClientSession 必须和创建它的 Client 绑定使用
如果你从 client_a 创建了 session，却把它传给 client_b.database(...).collection(...) 的操作，会直接 panic 并报错 InvalidSession 或类似提示。
- 每个
ClientSession内部持有一个对原始Client的弱引用（或等效绑定），跨 client 使用违反驱动设计契约 - 常见误用场景：在依赖注入容器里复用
Client，但把session传给另一个模块持有的不同Client实例 - 解决方案：确保 session 生命周期内，所有操作都通过同一个
Client实例获取Database和Collection
异步回调里怎么安全传 ClientSession
不能直接 move 借用可变引用的 &mut ClientSession 进闭包，因为 async move 会尝试所有权转移，而 session 是栈上变量且需多次使用。
- 推荐做法：用
Arc<mutex>></mutex>包裹（适用于简单场景），或更轻量地用RefCell<ClientSession>+Rc（仅限单线程 tokio runtime，如#[tokio::main(flavor = "current_thread")]） - 生产环境建议：把事务逻辑封装成同步函数，由外层 async 函数按顺序 await 调用，避免跨 await 边界共享可变 session
- 切忌：在
task::spawn()中传&mut session—— borrow checker 会直接拒绝，且并发修改 session 状态会导致未定义行为
事务失败后 commit_transaction() 报 UNKNOWN_TRANSACTION_COMMIT_RESULT 怎么办
这不是 bug，而是 MongoDB 的设计事实：网络抖动或节点故障可能导致驱动无法确认 commit 是否真正落地。此时你不能假设成功或失败，必须做幂等重试。
- 检查错误 label：
err.contains_label("UNKNOWN_TRANSACTION_COMMIT_RESULT")，而非匹配字符串 - 重试前先
session.abort_transaction().await?，再重新start_transaction() - 关键：重试逻辑必须基于业务 ID（如订单号）做幂等判断，不能无条件重放整个事务体
- 注意：
abort_transaction()本身也可能返回UNKNOWN_TRANSACTION_COMMIT_RESULT，需同样处理
事务最易被忽略的点是「session 生命周期管理」——它既不是全局单例，也不能跨 task 共享，更不能在 await 后继续用同一可变引用。写事务代码时，先画出 session 的借用路径，比急着写 insert 更重要。
