Navicat连接MongoDB副本集必须显式列出全部节点并指定replicaSet参数，漏节点或缺replicaSet会导致连接卡在SECONDARY状态；密码含@/:需URL编码；authSource必须与用户创建库一致（如admin），不能误用目标数据库名；SSL开关须严格匹配服务端配置；建议添加readPreference=primary确保写操作。
连接字符串必须包含完整节点列表和 replicaSet 参数
navicat 不支持只填一个节点再靠自动发现找副本集 —— 它不会发起 ismaster 或 replsetgetstatus 请求去探测其他成员。漏掉任一节点，或没加 ?replicaset=xxx，就会连上但始终卡在 secondary 状态，甚至报 failed to connect to server。
- 正确写法：
mongodb://admin:pass%40123@192.168.1.10:27017,192.168.1.11:27017,192.168.1.12:27017/admin?replicaSet=myRepl&authSource=admin - 节点间用英文逗号分隔，不能有空格；端口必须明确写出（Docker 或云服务常非 27017）
-
replicaSet值必须与初始化时执行rs.initiate()中的_id完全一致（大小写敏感） - 如果密码含
@、/、:，必须 URL 编码，否则解析会把密码截断成 host
authSource 不能填成你想要访问的数据库名
很多人在 Navicat 界面里把“Database”字段填了 myapp，又把“Authentication Database”也填成 myapp，结果连得上但看不到任何 collection —— 因为用户实际建在 admin 库里，而 Navicat 默认拿你填的 Database 当 authSource。
- 无论你要连哪个库（比如
myapp），只要用户是用db.createUser(..., {roles:[...], db:"admin"})创建的，authSource就必须是admin - 云服务如 MongoDB Atlas 要求
authSource=$external，这个值不能手改，填错直接认证失败 - Navicat 界面中 “Database” 字段只影响连接后默认展开的库，不参与认证；真正管认证的是 “Authentication Database” 输入框
SSL 开关必须跟服务端配置严格对齐
副本集各节点 SSL 配置通常一致，但本地测试和云环境差异极大：本地单机副本集默认无 TLS，Atlas 或阿里云 MongoDB 强制 TLS 且校验证书。Navicat 里 SSL 开关错一位，就会卡在握手超时，而不是报明文错误。
- 本地搭建的副本集（如 Docker Compose 或 Windows 多实例）：关闭 Navicat 的
SSL选项，否则连接 hang 住 - MongoDB Atlas / 腾讯云 TDMQ / 阿里云 MongoDB：必须勾选
SSL→ 选Require SSL，并勾选Validate Certificate，填入 CA 证书路径（如/path/to/atlas-ca.pem） - 若用自签名证书，需额外在系统级信任该证书，仅 Navicat 里导入无效
副本集连接成功但只读？检查是否连到了 SECONDARY 节点
Navicat 默认行为是随机连接列表中的某个节点，可能直连到从节点 —— 此时你看到库名、collection 列表都正常，但执行写操作（如插入文档）会报 not master 错误。
- 解决方法：在连接字符串末尾加
&readPreference=primary，强制路由到主节点 - 更稳妥的做法是加
&directConnection=false（默认值），让驱动走副本集发现逻辑，自动识别 PRIMARY - 验证方式：连上后右键点击连接名 → “运行命令”，输入
db.isMaster()，看返回中ismaster: true是否为真
authSource 和 Database 在 Navicat 界面里是两个独立输入框，极易混淆。
