mongodb单节点实例调用starttransaction()一定失败，因事务依赖oplog和majority write concern，而单机模式既不生成oplog，也无法满足w:"majority"，服务端协议层直接禁用该命令，返回commandnotsupportedonserver。
MongoDB 单节点实例调用 startTransaction() 一定失败，不是配置漏了、驱动旧了或代码写错了，是服务端协议层直接禁用——它压根不认这个命令。
为什么 CommandNotSupportedOnServer 错误无法绕过
事务在 MongoDB 中依赖两个底层机制：oplog（操作日志）和 majority write concern。单节点模式既不生成 oplog，也无法满足 w: "majority"（因为“多数”至少需要 2 个可投票节点，而单节点只有自己）。服务端在收到 startTransaction 命令时，会立即返回 CommandNotSupportedOnServer 或 Transaction numbers are only allowed on a replica set member，连解析参数这步都跳过。
验证方式极简单：db.runCommand({ replSetGetStatus: 1 }) 在单机上必然报 no replset config has been received；rs.status() 直接抛错，而不是返回状态对象。
以下操作全无效：
-
--enableMajorityReadConcern只影响读关注行为，不启用事务 -
storage.journal.enabled: true仅增强单节点持久性，和 oplog 无关 - 在连接字符串里加
?readConcernLevel=snapshot—— 连事务都没开起来，读关注无从谈起
如何把本地单节点快速转成事务可用的单成员副本集
核心不是“多实例”，而是让 mongod 实例声明自己属于某个副本集，并完成初始化。所有操作可在同一台机器、同一端口（如 27017）、不改应用连接字符串的前提下完成。
关键步骤：
- 停掉当前运行的 mongod（避免端口冲突）
- 新建空数据目录，例如
/data/rs0（Windows 下可用C:\data\rs0），确保 mongod 有读写权限 - 用以下命令启动：
mongod --replSet rs0 --dbpath /data/rs0 --port 27017 --bind_ip localhost - 用
mongosh --host localhost:27017连入，执行：rs.initiate({ _id: "rs0", members: [{ _id: 0, host: "localhost:27017" }] }) - 等待
rs.status().stateStr返回"PRIMARY"（通常几秒内完成）
⚠️ 必须用 localhost，不能用 127.0.0.1 或主机名——驱动内部做主机名匹配，不一致会导致 startSession() 成功但后续事务操作被静默拒绝。
事务能 start 了，但 commit 失败？检查 readConcern 和 writeConcern
副本集就绪 ≠ 事务自动可靠。MongoDB 强制要求事务内所有读写显式声明一致性级别，否则提交阶段报错或降级失效。
必须满足：
- 读操作需指定
readConcern: { level: "majority" }（4.2+ 推荐）或"snapshot"（4.0+）；"local"不被允许 - 写操作需指定
writeConcern: { w: "majority" }；设成{ w: 1 }会触发Transaction numbers require a majority错误 - Node.js 驱动示例：
session.startTransaction({ readConcern: { level: "majority" }, writeConcern: { w: "majority" } })
PyMongo 中若漏传 session= 参数到每个 insert_one()、update_one()，操作就脱离事务上下文——表面成功，实则已独立提交，这是最隐蔽的“假事务”来源。
连接字符串里没带 replicaSet=rs0，事务照样失效
即使 mongod 已是副本集，客户端仍需明确告知自己要连副本集。单节点连接字符串 mongodb://localhost:27017 会让驱动以 standalone 模式协商协议，startTransaction() 调用会被跳过或静默失败。
正确写法：mongodb://localhost:27017/?replicaSet=rs0（注意问号后参数）
验证是否生效：db.adminCommand({ isMaster: 1 }) 返回结果中必须含 setName: "rs0" 字段；Java 驱动可查 MongoClient.getClusterDescription().getType() 是否为 REPLICA_SET。
本地开发常用 Docker 单容器跑事务逻辑，但连接字符串仍写 localhost:27017，上线连真实副本集却用 replicaSet= 参数——这种环境差异导致“线下能跑、线上报错”，是最容易被忽略的部署断点。
