问题：MongoDB连接为何报错"not master and slaveOk=false"?

Question

在使用MongoDB时，连接报错“not master and slaveOk=false”是一个常见问题。该错误通常发生在客户端尝试从副本集的从节点（secondary）读取数据时，默认情况下，MongoDB不允许从从节点读取数据，除非明确启用此功能。造成该问题的原因主要有：1. 客户端连接的是从节点而非主节点；2. 未设置读偏好（read preference）为`secondary`或`secondaryPreferred`；3. 在连接字符串中未正确配置副本集参数。解决方法包括：确认连接的是主节点、在连接配置中添加`slaveOk=true`或设置合适的读偏好，以及检查副本集成员状态是否正常。理解副本集架构和读写机制是避免此类错误的关键。

Answer 1

一、问题背景与常见现象

在使用 MongoDB 副本集（Replica Set）架构时，开发者常会遇到连接报错："not master and slaveOk=false"。该错误通常出现在客户端尝试从副本集的从节点（secondary）读取数据时。

• MongoDB 默认只允许从主节点（primary）进行读写操作；
• 若未正确配置读偏好（read preference），尝试从 secondary 节点读取数据将触发此错误；
• 该问题可能发生在开发环境、测试环境或生产环境中。

二、错误成因深度解析

造成“not master and slaveOk=false”错误的主要原因如下：

1. 客户端连接的是从节点而非主节点：MongoDB 的副本集中，默认情况下只有主节点接受写操作和读操作（除非明确允许）。
2. 未设置合适的读偏好（Read Preference）：如果希望从 secondary 读取数据，必须显式设置 read preference 为 secondary 或 secondaryPreferred。
3. 连接字符串中未正确配置副本集参数：如未指定 replicaSet 名称，可能导致客户端连接到非预期的节点。

三、诊断流程与分析方法

当出现该错误时，建议按照以下步骤进行排查：

步骤	操作内容	目的
1	检查当前连接的节点是否为主节点	确认是否连接到了正确的 primary 节点
2	执行命令 rs.isMaster()	查看副本集成员状态及角色
3	检查连接字符串中的 readPreference 配置	确保设置了合适的读偏好策略
4	验证是否启用 slaveOk=true	判断是否允许从 secondary 读取数据

四、解决方案与代码示例

根据上述分析，可采取以下几种方式解决该问题：

• 方案一：确保连接到主节点

• // 示例：通过 MongoDB 客户端连接主节点
  const { MongoClient } = require('mongodb');
  const uri = 'mongodb://primary-host:27017/mydb?replicaSet=myReplicaSet';
  const client = new MongoClient(uri);
  await client.connect();

• 方案二：设置读偏好为 secondary 或 secondaryPreferred

• // 使用 readPreference 参数
  const uri = 'mongodb://host1,host2/mydb?replicaSet=myReplicaSet&readPreference=secondaryPreferred';

• 方案三：手动启用 slaveOk

• db.getMongo().setSlaveOk(true); // 在 shell 中临时启用

五、系统架构视角下的优化建议

为避免此类问题频繁发生，建议从系统架构层面进行优化：

1. 合理配置副本集拓扑结构，确保主节点稳定运行；
2. 在应用层统一封装 MongoDB 连接逻辑，避免硬编码连接地址；
3. 结合负载均衡器或服务发现机制自动识别主节点；
4. 引入监控系统持续检测副本集健康状态。

六、Mermaid 流程图展示诊断过程

graph TD
    A[开始] --> B{是否连接主节点？}
    B -- 是 --> C[正常访问]
    B -- 否 --> D{是否启用slaveOk或secondary读偏好？}
    D -- 是 --> E[允许读取]
    D -- 否 --> F[报错："not master and slaveOk=false"]