用 Na vicat 连接 MongoDB 副本集时，有几个条件一个都不能少：必须显式写出全部节点，并带上 replicaSet 参数；少写节点，或者没配 replicaSet，连接就很容易一直卡在 SECONDARY 状态。还有一处特别容易踩坑——如果密码里带有 @、/、: 这类字符，必须先做 URL 编码。认证库也不能写错，authSource 必须和用户实际创建所在的库保持一致，比如是 admin 就写 admin，别误填成目标数据库名。至于 SSL 开关，也得和服务端配置严格对齐，开或不开都不能想当然。为了保证写操作走主节点，通常还建议补上 readPreference=primary。

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

Na vicat 这点很容易踩坑：它不支持只填一个节点，然后靠自动发现把整个副本集补全。原因也很直接，它本身不会主动发起 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 不能填成你想要访问的数据库名

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

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

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

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

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

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

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

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