副本集不支持跨数据库事务，仅分片集群通过mongos连接且所有集合已分片时才支持；必须用session.getDatabase()而非db.getSiblingDB()，且config server与各shard均需为副本集。
MongoDB 事务跨数据库操作失败，不是代码写错了，而是部署架构或会话使用不满足硬性前提——副本集不支持跨库事务，只有分片集群（sharded cluster）才支持，且必须通过 mongos 连接、所有集合已注册为分片、session 正确绑定到各数据库实例。
为什么副本集下跨数据库事务一定失败
副本集（replica set）中所有数据库物理上共存于同一组节点，但事务引擎不允许多数据库上下文共享一个 session。这不是配置疏漏，而是服务端明确拒绝：
- MongoDB 6.0+ 会直接报错：
NotImplemented: Cross-database transactions are not supported in replica sets - 早期版本（如 4.2–5.0）则静默退化：
db.getSiblingDB("otherdb").coll.insertOne()看似执行成功，实则游离于事务外，回滚时不会撤回 -
rs.status()返回"ismaster": true或"isreplicaset": true，就说明当前连接不满足跨库前提
如何确认当前连接支持跨库事务
三步验证，缺一不可：
- 查连接类型：
db.runCommand({isMaster: 1}).msg === "isdbgrid"—— 只有返回isdbgrid才表示连的是mongos，这是跨库事务的入口网关 - 查分片状态：
sh.status({verbose: false})中必须含非空shards字段，且enabled: true；若提示sharding version: not enabled，说明分片未启用 - 查集群角色：
db.runCommand({serverStatus: 1}).sharding.inShardedCluster === true—— 仅mongos返回该字段，mongod直连永远不返回
跨库事务写法必须用 session.getDatabase()，不能用 db.getSiblingDB()
db.getSiblingDB() 返回的是新数据库对象，但它不继承当前 session 上下文，所有操作自动脱离事务。正确方式是全程通过 session 派生数据库实例：
const session = client.startSession();
session.startTransaction();
// ✅ 正确：全部通过 session 绑定
const db1 = session.getDatabase("db_a");
const db2 = session.getDatabase("db_b");
db1.collection("users").updateOne({ _id: 1 }, { $inc: { balance: -100 } });
db2.collection("logs").insertOne({ action: "transfer", ts: new Date() });
await session.commitTransaction();
- 错误写法：
db.getSiblingDB("db_b").collection("logs").insertOne(...)→ 不在事务中 - 即使两个数据库都已启用分片（
sh.enableSharding("db_a")、sh.enableSharding("db_b")），也必须走session.getDatabase() - Laravel、TypeORM 等 ORM 若封装了多连接，默认不透传
session，需手动从底层 driver 提取并注入
容易忽略的部署细节：config server 和分片都必须是副本集
分片集群看似启动成功，但若 config server 或任一分片是单节点 mongod，跨库事务仍会失败。MongoDB 要求：
- config server 必须是三节点副本集（自 4.4 起强制）
- 每个 shard 必须是副本集，不能是单节点 mongod（否则
mongos无法协调两阶段提交） - 检查方式：分别连接 config server 和各 shard，执行
rs.status()，确认ok: 1且成员状态正常 - 常见坑：Docker Compose 中 config server 使用
mongod --configsvr但未加--replSet，导致它实际是单节点
跨库事务不是“能不能写代码”的问题，而是“有没有资格发起协调”的问题。一旦发现 Transaction numbers are only allowed on a sharded cluster 或静默不回滚，优先停掉应用层重试，先用 shell 连 mongos 跑三步验证——90% 的失败源于连接目标或集群拓扑不符合最低要求。
