mongodb 4.0 事务无法在单机模式运行，因其硬性依赖副本集的oplog机制；必须将单机实例升级为单成员副本集（--replset + rs.initiate），并配置readconcern="snapshot"和writeconcern={w:"majority"}方可启用。
MongoDB 4.0 事务无法启动，**不是代码写错了，也不是驱动版本不对，而是服务端压根没允许你进事务的门**——只要 mongod 是单机模式启动的，startTransaction() 必然失败，报错类似 Transaction numbers are only allowed on a replica set member or mongos 或 CommandNotSupportedOnServer。
为什么单机 mongod 一调 startTransaction() 就报错
事务从 MongoDB 4.0 起就硬依赖副本集的 oplog 机制：事务编号、快照读（readConcern: "snapshot"）、冲突检测、回滚日志全靠它。单机模式不生成 oplog，也没有主从协调能力，服务端在协议层直接禁用所有事务命令。
验证很简单：db.runCommand({ replSetGetStatus: 1 }) 在单机上一定返回 no replset config has been received——这比查 db.version() 还准。
--enableMajorityReadConcern、storage.journal.enabled: true 这些参数对事务完全无效，它们解决的是读关注或持久化问题，不是事务准入问题。
如何用最小改动让本地 mongod 支持事务
不需要多台机器，也不用改应用连接地址（仍连 localhost:27017），只要让这个 mongod “声明自己是副本集成员”即可。核心就两步：启动带 --replSet 参数 + 连上去执行 rs.initiate()。
- 停掉当前运行的
mongod（避免端口冲突） - 新建空数据目录，例如
/data/rs0（Windows 下可用C:\data\rs0），确保mongod有读写权限 - 用以下命令启动：
mongod --replSet rs0 --dbpath /data/rs0 --port 27017 --bind_ip localhost - 用
mongo连入：mongo --host localhost:27017 - 执行：
rs.initiate({ _id: "rs0", members: [{ _id: 0, host: "localhost:27017" }] })（必须用localhost，不能用127.0.0.1，否则驱动解析主机名失败会导致事务 session 创建被拒） - 等
rs.status().stateStr返回"PRIMARY"即可
事务能 start 了，但 commit 失败？检查 readConcern 和 writeConcern
副本集有了，不代表事务自动可靠。MongoDB 强制要求事务内所有读写操作显式指定兼容级别，否则会静默降级或报错。
- 读操作必须设
readConcern: "majority"（4.2+ 推荐）或"snapshot"（4.0+）；"local"不被允许 - 写操作必须设
writeConcern: { w: "majority" }；设成{ w: 1 }会触发错误Transaction numbers require a majority - Java 驱动中每个操作都必须传入同一
ClientSession实例，漏传或传错 session 会导致操作脱离事务上下文 - 事务内不能执行
createCollection、dropDatabase等管理命令，也不能操作capped集合或system.*集合
最常被忽略的点是：事务 session 的生命周期和异常处理必须严格匹配——startTransaction() 后没 commitTransaction() 或 abortTransaction()，事务会挂起直到 60 秒超时自动 abort，期间占用资源且可能阻塞后续操作。
