MongoDB副本集通过主从节点架构实现数据冗余和高可用，默认情况下所有读写请求都会发送到主节点。要实现读写分离，核心是通过配置读偏好，将读请求路由到从节点，从而分摊主节点的负载。
MongoDB副本集读写分离的核心原理
MongoDB副本集包含主节点和多个从节点，主节点负责处理所有写请求，从节点通过复制主节点的oplog同步数据。读写分离的实现依赖于read_preference参数，该参数决定了客户端发送读请求时的节点选择策略，不需要修改副本集本身的配置，仅需要在客户端连接时指定即可。
read_preference的常用模式
MongoDB提供了多种读偏好模式，不同模式对应不同的节点选择逻辑，开发者可以根据业务对数据一致性的要求选择合适的模式：
- primary：默认模式，所有读请求都发送到主节点，保证读到最新数据，但无法实现读写分离。
- primaryPreferred：优先选择主节点，如果主节点不可用，再从从节点读取，适合对数据一致性要求高但希望主节点故障时能降级读的场景。
- secondary：只从从节点读取数据，完全实现读写分离，但可能读到旧数据，适合对数据实时性要求不高的查询场景。
- secondaryPreferred：优先选择从节点，如果从节点不可用，再选择主节点，是最常用的读写分离模式，兼顾了可用性和负载分摊。
- nearest：选择网络延迟最低的节点，无论主从，适合对延迟敏感且能接受最终一致性的场景。
不同场景下的模式选择建议
| 业务场景 | 推荐模式 | 原因说明 |
|---|---|---|
| 订单支付、账户余额查询 | primary | 这类场景对数据一致性要求极高，必须读取最新数据，不适合读写分离 |
| 商品详情页浏览、历史订单查询 | secondaryPreferred | 对数据实时性要求不高，优先从从节点读，分摊主节点压力 |
| 报表统计、离线数据分析 | secondary | 完全从从节点读取，避免影响线上业务主节点性能 |
客户端配置读写分离示例
Node.js客户端配置
使用官方MongoDB Node.js驱动时，可以在连接字符串或者操作选项中指定read_preference：
// 连接字符串中指定读偏好为secondaryPreferred
const { MongoClient } = require('mongodb');
const uri = 'mongodb://192.168.0.1:27017,192.168.0.2:27017,192.168.0.3:27017/testdb?replicaSet=rs0&readPreference=secondaryPreferred';
const client = new MongoClient(uri);
async function queryData() {
try {
await client.connect();
const db = client.db('testdb');
const collection = db.collection('users');
// 也可以在单个查询中覆盖读偏好配置
const result = await collection.find({ status: 1 }).toArray();
console.log(result);
} finally {
await client.close();
}
}
queryData().catch(console.error);
Python客户端配置
使用PyMongo驱动时，同样可以在连接或操作中指定读偏好：
from pymongo import MongoClient, ReadPreference
# 连接时指定全局读偏好为secondaryPreferred
client = MongoClient(
'mongodb://192.168.0.1:27017,192.168.0.2:27017,192.168.0.3:27017/?replicaSet=rs0',
read_preference=ReadPreference.SECONDARY_PREFERRED
)
db = client.testdb
collection = db.users
# 单个查询也可以单独指定读偏好
result = collection.find({'status': 1}).read_preference(ReadPreference.SECONDARY)
for doc in result:
print(doc)
注意事项
- 从节点的数据同步存在延迟，使用secondary相关模式时，可能会读到尚未同步的旧数据，业务需要能接受最终一致性。
- 如果副本集只有1个主节点和1个从节点，从节点故障后，secondary模式会导致读请求失败，建议生产环境至少部署1主2从。
- 不要在写操作后立即使用secondary模式读取刚写入的数据，大概率读不到，这类场景建议使用primary模式或者增加重试逻辑。
读写分离不是银弹，需要根据业务场景选择合适的读偏好模式，不能为了分离而分离，否则可能引入数据不一致的问题。
mongodb副本集读写分离read_preference修改时间：2026-06-10 17:48:35