MongoDB事务仅支持副本集或分片集群，单节点不支持；开发需搭建三节点副本集并用WithTransactionAsync正确管理事务生命周期，所有操作须传入session且限于单库。
事务必须在副本集或分片集群中运行，单节点 MongoDB 不支持
本地开发时用 mongod --dbpath ./data 启动的单机实例，调用 StartSession 后执行 WithTransaction 会直接抛出 NotSupportedException: Transactions are not supported on standalone servers。这不是代码写错了，是部署模式不满足前提。
实操建议：
- 开发阶段改用三节点副本集：启动三个
mongod实例并用rs.initiate()初始化，连接字符串指向主节点（如mongodb://localhost:27017/?replicaSet=rs0） - 确认副本集状态：在 mongo shell 中执行
rs.status().members.map(m => m.stateStr)，至少有一个PRIMARY - Docker 用户可直接用官方镜像加
--replSet rs0参数，并运行初始化脚本
StartSession + WithTransaction 是唯一推荐的事务入口，别手动调用 StartTransaction
IClientSessionHandle 的 StartTransaction 方法仅用于底层控制，.NET Driver 明确要求通过 WithTransaction 自动管理生命周期——它会自动处理提交、回滚、异常重试和会话释放。手动调用 StartTransaction 后忘记 AbortTransaction 或 CommitTransaction，会导致会话卡住、锁未释放、后续事务失败。
正确写法示例：
using var session = await client.StartSessionAsync();
await session.WithTransactionAsync(async (s, ct) =>
{
var orders = database.GetCollection<Order>("orders", new MongoCollectionSettings { ReadPreference = ReadPreference.Primary });
var inventory = database.GetCollection<Inventory>("inventory", new MongoCollectionSettings { ReadPreference = ReadPreference.Primary });
await orders.InsertOneAsync(s, new Order { Id = "O123", Items = [...] }, ct);
await inventory.UpdateOneAsync(s,
Builders<Inventory>.Filter.Eq("sku", "SKU-001"),
Builders<Inventory>.Update.Inc("quantity", -10),
ct);
});
注意点：
由 ReMe 驱动的记忆管理系统，支持跨会话记忆持久化、自动应用用户偏好以及智能上下文压缩...
-
WithTransactionAsync内部已封装重试逻辑，默认最多重试一次；若需自定义，传入TransactionOptions设置MaxCommitTime或ReadConcern - 所有集合操作必须显式传入
session对象（如InsertOneAsync(s, ...)），漏传就变成非事务操作 - 事务内不能跨数据库操作（即不能在一个事务里同时写
db1.col1和db2.col2）
超时和锁等待容易被忽略：事务默认 60 秒自动终止，且不支持行级锁提示
MongoDB 事务没有类似 SQL 的 SELECT ... FOR UPDATE，所有写操作在提交前都持有文档级锁。如果两个事务并发修改同一文档，后到者会阻塞，直到前一个事务提交或超时。而默认的 transactionLifetimeLimitSeconds 是 60 秒，超时后服务端强制中止，客户端收到 CommandException 带有 "transientTransactionError" 标识。
应对方式：
- 在连接字符串中显式设置更合理的超时：
mongodb://.../?maxIdleTimeMS=60000&minPoolSize=5&transactionLifetimeLimitSeconds=120 - 避免长事务：把耗时操作（如 HTTP 调用、文件读写）移出
WithTransactionAsync回调体 - 业务层加幂等键（如
order_id唯一索引）来兜底重复提交，而不是依赖事务重试
异步取消（CancellationToken）不会中断正在执行的事务操作
WithTransactionAsync 接收 CancellationToken，但它只控制回调函数的执行入口是否被取消，**不中断 MongoDB 服务端已接收的命令**。也就是说，即使你调用 cancellationTokenSource.Cancel()，只要命令已发往服务器，事务仍会继续执行直至完成或超时。
这意味着：
- 不要指望用
CancellationToken来“快速终止”一个慢事务 - 真正需要中断时，只能靠服务端超时机制（
transactionLifetimeLimitSeconds）或主动 killOp（不推荐） - 客户端能做的只有提前放弃等待结果，但服务端工作照旧——这在高并发写同一批文档时可能加剧锁竞争
