mongodb单机模式不支持事务，必须部署为副本集或分片集群；本地开发可启用单成员副本集并配置readconcern="snapshot"和writeconcern={w:"majority"}来启用事务。
MongoDB 在单机模式下根本不支持事务，直接封装 UnitOfWork 并调用 BeginTransactionAsync 会抛出 Standalone servers do not support transactions 错误——这不是代码写得不对，而是 MongoDB 底层限制。
MongoDB 单机环境调用 BeginTransactionAsync 必然失败
官方驱动的 IMongoClient 和 IMongoDatabase 确实暴露了 StartSession 和 WithTransaction 方法，但这些仅在副本集（Replica Set）或分片集群（Sharded Cluster）中才真正启用事务语义。本地开发默认启动的 mongod --dbpath 是纯单节点模式，此时：
-
session.StartTransaction()会静默忽略或立即抛出异常 - 任何对
CommitTransactionAsync或AbortTransactionAsync的调用都无效 - 即使你封装了类似 EF Core 风格的
IUnitOfWork接口，底层没有协调器，事务原子性无法保障
别被接口名误导——StartSession 不等于“开启事务”，它只是为后续可能的分布式操作准备上下文，在单机下它退化为普通会话。
替代方案：用 Session + Try-Catch 模拟事务语义
若你必须在单机环境实现“一组操作全成功或全失败”的效果，只能靠应用层补偿逻辑，而非数据库事务。可行路径是：
- 用
client.StartSession()获取IClientSessionHandle，显式传入每个InsertOneAsync、UpdateOneAsync等操作 - 所有操作包裹在
try/catch中，捕获MongoWriteException或业务校验失败时，手动回滚已执行的变更（比如删掉刚插入的文档、还原上一步更新） - 避免跨集合强一致性要求；MongoDB 天然适合最终一致性场景，例如用事件日志+后台任务修复不一致
示例关键片段：
一款AI工具，主要用于一款基于 Rust 的快速无头浏览器自动化命令行工具（CLI），支持 Node.js 回退机制，可使 AI agent 通过结构化命令实现页面导航、点击、输入及截图，适合需要提升相关任务效率的用户。
using var session = _client.StartSession();
session.StartTransaction();
try
{
await _collection1.InsertOneAsync(session, doc1);
await _collection2.UpdateOneAsync(session, filter, update);
await session.CommitTransactionAsync();
}
catch
{
await session.AbortTransactionAsync(); // 此调用在单机下无副作用，但保持接口一致
throw;
}
注意：AbortTransactionAsync 在单机下什么也不做，别依赖它清理数据。
真正支持事务的最小部署：三节点副本集
要让 MongoDB 事务生效，必须初始化副本集。本地开发可快速搭建：
- 启动三个
mongod实例，分别指定不同--port和--dbpath - 用
mongosh连接任一节点，执行rs.initiate()和rs.add("localhost:27018")等加入其他节点 - 连接字符串改为
mongodb://localhost:27017,localhost:27018,localhost:27019/?replicaSet=rs0 - 此时
StartSession().StartTransaction()才真正起作用，CommitTransactionAsync会触发两阶段提交
封装 UnitOfWork 类时，务必检查 database.RunCommandAsync(new BsonDocument("isMaster", 1)) 返回结果中是否有 "ismaster": true 和 "hosts" 字段，否则提前拒绝启用事务逻辑。
最容易被忽略的一点：很多封装库把 IMongoSession 生命周期和 HTTP 请求生命周期强行绑定，但 MongoDB Session 不是线程安全的，也不能跨 await 边界复用——每次事务必须用新 session，且不能在异步方法中传递 session 实例再 await 其他操作，否则会报 Session is no longer valid。
