分片事务仅支持 readConcern: "majority",因其依赖两阶段提交且无法跨片保证谓词快照或范围锁;该级别确保读取已多数持久化的数据,避免脏读但不防止幻读,且必须在事务启动时显式指定。

分片集群事务中,readConcern: "majority" 是唯一可选且必须显式设置的级别;其他如 "linearizable" 或 "snapshot" 在分片事务中不被支持,强行指定会直接报错。
为什么分片事务只允许 readConcern: "majority"
MongoDB 分片事务的协调机制依赖于 mongos 与各分片的两阶段提交(2PC),而谓词快照、范围锁等能力在跨片场景下无法全局保证。官方明确限制:分片事务仅接受 "majority" 级别 —— 它确保你读到的数据已在多数分片上持久化,避免回滚导致的脏读,但不提供幻读防护,也不冻结查询谓词的逻辑边界。
常见错误现象:
- 设置 readConcern: "linearizable" 启动事务时抛出 InvalidOptions: read concern linearizable is not supported in sharded transactions
- 误以为 "majority" 能阻止幽灵读取,结果在两次 find({ status: "pending" }) 之间,另一事务插入新文档并提交,第二次查询仍返回该行
使用场景:
- 需要强一致性读(比如金融对账、库存扣减前校验)
- 接受幻读风险,但不能容忍读到未来可能回滚的数据
如何在不同层级正确设置 readConcern
优先级顺序为:事务 > 集合 > 数据库 > 客户端。分片事务中,readConcern 必须在事务启动时指定,继承自上层的设置会被忽略。
- Java 驱动示例(推荐):
TransactionOptions txnOpts = TransactionOptions.builder() .readConcern(ReadConcern.MAJORITY) .writeConcern(WriteConcern.WMajority) .build(); session.startTransaction(txnOpts); - 连接字符串中设
readConcernLevel对事务无效 —— 它只影响非事务读操作 - 在
mongosh中启动事务时必须显式传参:session.startTransaction({ readConcern: { level: "majority" } });,省略或写成{ level: "local" }会导致事务拒绝启动
分片事务中 readConcern: "majority" 的实际行为边界
它只锚定“哪些文档已多数提交”,不锚定“哪些文档满足查询条件”。关键限制包括:
- 不维护谓词快照:即使第一次查询没命中某条记录,只要它在事务
clusterTime之前已由其他事务提交,第二次查询就可能看到 - 不锁定索引范围:
{ status: "pending" }查询不会阻止其他事务向同一分片插入新pending文档 - 分片迁移期间行为更不可控:若 chunk 正在迁移,
"majority"读可能从源片和目标片分别取数,造成短暂不一致 - 性能开销:每次读需等待多数分片响应,延迟高于
"local",尤其在跨地域部署时明显
真正容易被忽略的一点
很多人以为只要开了事务 + readConcern: "majority" 就“安全了”,却忘了分片事务中 readConcern 不参与谓词判定 —— 它只管“数据是否已落盘”,不管“数据是否该出现在这次查询结果里”。业务逻辑若依赖两次读结果集完全一致(比如先查余额再扣款),必须自行加分布式锁或改用单文档嵌套结构,不能指望数据库层隔离。


















