Navicat连接MongoDB副本集如何设置

Navicat连接MongoDB副本集必须显式列出全部节点并指定replicaSet参数，漏节点或缺replicaSet会导致连接卡在SECONDARY状态；密码含@/:需URL编码；authSource必须与用户创建库一致（如admin），不能误用目标数据库名；SSL开关须严格匹配服务端配置；建议添加readPreference=primary确保写操作。

连接字符串必须包含完整节点列表和 replicaSet 参数

Navicat 不支持只填一个节点再靠自动发现找副本集 —— 它不会发起 isMaster 或 replSetGetStatus 请求去探测其他成员。漏掉任一节点，或没加 ?replicaSet=xxx，就会连上但始终卡在 SECONDARY 状态，甚至报 failed to connect to server。

1. 正确写法：mongodb://admin:pass%[email protected]:27017,192.168.1.11:27017,192.168.1.12:27017/admin?replicaSet=myRepl&authSource=admin
2. 节点间用英文逗号分隔，不能有空格；端口必须明确写出（Docker 或云服务常非 27017）
3. replicaSet 值必须与初始化时执行 rs.initiate() 中的 _id 完全一致（大小写敏感）
4. 如果密码含 @、/、:，必须 URL 编码，否则解析会把密码截断成 host

authSource 不能填成你想要访问的数据库名

很多人在 Navicat 界面里把“Database”字段填了 myapp，又把“Authentication Database”也填成 myapp，结果连得上但看不到任何 collection —— 因为用户实际建在 admin 库里，而 Navicat 默认拿你填的 Database 当 authSource。

1. 无论你要连哪个库（比如 myapp），只要用户是用 db.createUser(..., {roles:[...], db:"admin"}) 创建的，authSource 就必须是 admin
2. 云服务如 MongoDB Atlas 要求 authSource=$external，这个值不能手改，填错直接认证失败
3. Navicat 界面中 “Database” 字段只影响连接后默认展开的库，不参与认证；真正管认证的是 “Authentication Database” 输入框

SSL 开关必须跟服务端配置严格对齐

副本集各节点 SSL 配置通常一致，但本地测试和云环境差异极大：本地单机副本集默认无 TLS，Atlas 或阿里云 MongoDB 强制 TLS 且校验证书。Navicat 里 SSL 开关错一位，就会卡在握手超时，而不是报明文错误。

1. 本地搭建的副本集（如 Docker Compose 或 Windows 多实例）：关闭 Navicat 的 SSL 选项，否则连接 hang 住
2. MongoDB Atlas / 腾讯云 TDMQ / 阿里云 MongoDB：必须勾选 SSL → 选 Require SSL，并勾选 Validate Certificate，填入 CA 证书路径（如 /path/to/atlas-ca.pem）
3. 若用自签名证书，需额外在系统级信任该证书，仅 Navicat 里导入无效

副本集连接成功但只读？检查是否连到了 SECONDARY 节点

Navicat 默认行为是随机连接列表中的某个节点，可能直连到从节点 —— 此时你看到库名、collection 列表都正常，但执行写操作（如插入文档）会报 not master 错误。

1. 解决方法：在连接字符串末尾加 &readPreference=primary，强制路由到主节点
2. 更稳妥的做法是加 &directConnection=false（默认值），让驱动走副本集发现逻辑，自动识别 PRIMARY
3. 验证方式：连上后右键点击连接名 → “运行命令”，输入 db.isMaster()，看返回中 ismaster: true 是否为真

副本集连接的关键不在“填对几个字段”，而在于 URI 各参数之间的协同关系：节点列表、replicaSet 名、authSource、SSL 开关、readPreference 这五项任意一项错配，都会导致看似连上实则不可用。尤其注意 authSource 和 Database 在 Navicat 界面里是两个独立输入框，极易混淆。