MongoDB测试副本集单操作读事务如何开启SECONDARY读偏好

核心原因 #

你遇到的报错是MongoDB早期版本对多文档事务的设计限制：

• MongoDB 4.0~4.2版本的所有事务，无论是否包含写操作，强制要求读偏好为PRIMARY。这是因为分布式事务需要保证全局一致的快照视图、以及提交的原子性，SECONDARY节点的数据是异步同步的，无法作为事务协调节点提供一致的事务读能力。

接口保留读偏好配置的意义 #

该参数并非冗余设计，是为了兼容后续版本的新特性：
MongoDB 5.0及以上版本推出了只读事务能力，这类仅包含读操作的事务允许使用SECONDARY、SECONDARY_PREFERRED等非主读偏好，充分利用从节点的读资源。此外分片集群的跨分片事务场景下，该配置也会用于适配分片级别的读路由规则。

可行解决方案 #

方案1：无需升级版本，放弃事务封装（适合你的单读操作场景） #

你当前的操作本身就是单文档读，没有配套的写操作需要保证原子性，完全不需要封装到事务中。直接发送带snapshot读关注+SECONDARY读偏好的普通读请求即可，语义和你预期的事务读完全一致，示例：

collection = client.mydb1.foo.with_options(
    read_concern=ReadConcern('snapshot'),
    read_preference=ReadPreference.SECONDARY
)
collection.find_one({'id': 0})

方案2：升级MongoDB到5.0+，使用只读事务 #

如果确实需要事务封装（比如后续要扩展多读读一致性的场景），升级版本后显式声明事务为只读即可，示例：

def callback(session):
    collection_one = session.client.mydb1.foo
    collection_one.find_one({'id': 0}, session=session)

with client.start_session() as session:
    session.with_transaction(
        callback, 
        read_concern=ReadConcern('snapshot'),
        write_concern=wc_majority,
        read_preference=ReadPreference.SECONDARY,
        read_only=True # 新增只读事务声明
    )

注意：只读事务读从节点时，需要保证副本集已开启enableMajorityReadConcern（默认开启），可合理配置max_staleness避免读取数据过旧的从节点。

内容的提问来源于stack exchange，提问作者Am4teur