MongoDB跨数据库事务仅在分片集群中支持，副本集不支持；必须通过mongos连接、sharding已启用、config server和分片均为副本集，否则事务静默失效或报错。
事务跨数据库失败，先确认是否在分片集群中运行
MongoDB 的跨数据库事务（即操作涉及 db1.collectionA 和 db2.collectionB）仅在分片集群（sharded cluster）中受支持；副本集（replica set）下不支持跨库事务，哪怕两个数据库物理上位于同一组节点。这不是配置疏漏或驱动问题，而是服务端硬限制。
常见错误现象：Transaction numbers are only allowed on a sharded cluster 或静默退化为非事务操作（无报错但不回滚）。
- 用
sh.status()在mongos上执行，若返回 “sharding version: not enabled”，说明未启用分片 - 连接的是
mongod直连地址（如mongodb://localhost:27017），而非mongos地址（如mongodb://mongos-host:27017），事务一定无法跨库 -
db.adminCommand({getCmdLineOpts: 1})中检查sharding配置项是否存在且生效
单副本集 ≠ 支持跨库事务，别被“多数据库”误导
副本集可含任意数量数据库，但事务 session 只能绑定单个分片——而副本集本身不是分片，它只是高可用单元。跨库操作在副本集中会被拒绝，即使所有集合都未分片、都在同一台 mongod 进程里。
验证方式：在副本集上尝试启动跨库事务，会收到 NotImplemented: Cross-database transactions are not supported in replica sets（MongoDB 6.0+ 明确报错）或早期版本的静默失败。
- 跨库事务必须由
mongos协调，且至少有一个集合已启用分片（sh.enableSharding("db_name")） - 未分片的集合可参与跨库事务，但前提是整个集群是分片架构，且事务通过
mongos发起 - 不要试图用
db.getSiblingDB()在副本集里“模拟”跨库——它不改变事务作用域
如何快速检查当前连接是否满足跨库事务前提
三步定位，避免在应用层反复试错：
- 查连接目标：
db.runCommand({isMaster: 1}).msg === "isdbgrid"表示连的是mongos；若返回"isreplicaset"或"ismaster"，则不满足 - 查分片状态：
sh.status({verbose: false})输出中必须有shards字段且非空，且enabled: true - 查事务能力：
db.runCommand({serverStatus: 1}).sharding.inShardedCluster === true（仅mongos返回该字段）
任一条件不满足，跨库事务就不可用——此时应重构数据模型（如合并数据库、改用嵌入式引用）或升级部署架构。
容易忽略的细节：配置服务器和分片必须都是副本集
分片集群看似启动了，但若配置服务器（config server）是单节点，或某个分片是单 mongod（非副本集），整个集群的事务能力会降级，跨库事务直接被禁用，且可能只在首次 sh.enableSharding() 时提示警告，后续无明确报错。
- 配置服务器必须是三节点副本集（
csrs），不能是单机或非副本集模式 - 每个分片必须是副本集，哪怕只含一个主节点加两个仲裁节点（
arbiter） -
mongos版本需 ≥ 4.2，且客户端驱动版本匹配（如 Node.js 驱动 ≥ 3.2）
最隐蔽的问题是：开发环境用单机 mongod 模拟分片，测试通过，上线后因配置服务器未按副本集部署，跨库事务始终静默失效——这种环境差异必须在部署检查清单里固化验证步骤。
