mongodb多语句事务仅支持副本集或分片集群，单节点standalone模式不支持；需初始化副本集、正确配置连接字符串，并在session中绑定所有操作，配对commit/abort，注意readconcern、超时及跨库限制。
MongoDB 的多语句事务必须在支持副本集或分片集群的部署中运行，单节点 standalone 模式不支持事务 —— 这是调试失败最常见的根本原因。
确认部署模式是否支持事务
事务在 MongoDB 中不是“开箱即用”的功能，它依赖底层复制机制来保证原子性和一致性。如果你用的是本地单节点 mongod 启动（比如通过 Compass 连接 localhost:27017 且未配置副本集），session.startTransaction() 会直接报错：Transaction numbers are only allowed on a replica set member or mongos。
- 检查当前连接是否指向副本集：在 Compass 的连接详情页或 shell 中运行
rs.status()；若报错no replset config或返回空，则不是副本集 - 本地开发想启用事务？必须初始化副本集：启动时加
--replSet rs0参数，并在 shell 中执行rs.initiate() - Compass 连接字符串里必须包含
?replicaSet=rs0，否则即使后端是副本集，驱动也不会启用事务上下文
在 mongosh 中手动调试事务的最小可运行结构
事务调试的关键是控制粒度：不能只写 session.startTransaction() 就跑，必须配对 commitTransaction() 或 abortTransaction()，且所有操作必须绑定到该 session。
- 正确写法示例（注意每行末尾无分号，mongosh 多行模式靠 Shift+Enter 换行）：
const session = db.getMongo().startSession()
session.startTransaction()
try {
session.getDatabase("test").getCollection("orders").insertOne({ order_id: 123, status: "pending" })
session.getDatabase("test").getCollection("inventory").updateOne({ sku: "A1" }, { $inc: { qty: -1 } })
session.commitTransaction()
} catch (error) {
session.abortTransaction()
throw error
} finally {
session.endSession()
}
session.getDatabase(...)，直接写 db.orders.insertOne(...) —— 这会走默认会话，不在事务内commitTransaction() 前加 printjson(session.getDatabase("test").orders.findOne({ order_id: 123 }))，但注意：未提交的数据对其他会话不可见在 Compass GUI 中无法直接运行事务，但能辅助验证
Compass 当前（v1.44+）不提供事务脚本编辑器或事务控制按钮，它的“嵌入式 shell”本质仍是 mongosh 实例，所以事务调试仍需手写代码。但它能帮你快速验证事务前后数据一致性：
- 打开两个 Collection 标签页（如
orders和inventory），分别设置自动刷新（右上角 ⏱️ 图标） - 在嵌入式 shell 中运行事务脚本，观察两个标签页是否同步更新（仅在 commit 后可见）
- 故意让事务抛错（例如 update 匹配不到文档），然后检查两个集合是否都保持原样 —— 这是验证 rollback 是否生效的最直观方式
- 注意：Compass 的“生成代码”功能对事务无效，它只支持单条 CRUD 查询转 shell 命令
容易被忽略的隔离与超时细节
事务不是万能锁，它的行为受 readConcern 和 writeConcern 控制，而默认值可能不符合预期。
- 默认
readConcern: "local"，意味着事务内读取可能看到未提交写入（脏读），调试时若发现“刚插进去就查不到”，先检查这个 - 事务有默认 60 秒超时（
maxTimeMS），长事务卡住时会自动 abort；可在startTransaction({ maxTimeMS: 300000 })中显式延长 - 事务内不能跨数据库操作（除非使用
session.getDatabase("db1").collection1和session.getDatabase("db2").collection2，但要求两个库在同一个分片或副本集上） - 索引缺失会导致事务内查询变慢，进而触发超时 —— 调试卡顿事务前，先用 Compass 的“性能”面板检查相关查询是否命中索引
事务调试真正的复杂点不在语法，而在于部署拓扑、会话绑定和隔离级别这三层嵌套约束；漏掉任意一层，都会表现为“事务没生效”或“莫名 abort”，而不是清晰的错误提示。
