必须使用mongodb://开头的连接字符串，否则直接报错；用户名密码含特殊字符需URL编码，authSource须与用户创建库一致（如admin），SSL开关须严格匹配服务端配置，且Navicat版本不得低于16。
连接字符串必须用 mongodb:// 开头，不能省略或写错
navicat 16+ 支持 mongodb 7.0，但连接失败的第一原因永远是 uri 格式错误。它不接受 mongo://、http://，也不接受只填 ip 和端口的“简写模式”。
-
mongodb://是强制前缀，漏掉直接报failed to connect to server - 用户名密码含
@、/、:必须 URL 编码 —— 比如密码pass/123@abc要写成pass%2F123%40abc - 本地单机默认端口是
27017，Docker 或云服务（如 Atlas）常改端口，务必确认实际监听端口 - 副本集必须写全节点，例如：
mongodb://u:p@node1:27017,node2:27017/admin?replicaSet=rs0
authSource 填错会导致“连得上但看不到库”
Navicat 界面里有“数据库名”输入框，但它 ≠ authSource。MongoDB 用户是绑定在某个数据库上的（通常是 admin），认证必须去那个库找用户凭证。
- 如果你用
db.createUser(...)在admin库创建的用户（生产环境标准做法），连接参数里必须显式加?authSource=admin - 云服务如 MongoDB Atlas 要求
authSource=$external，填admin会认证通过但列不出 collections - Navicat 的“Database”字段只决定你连上去默认打开哪个库，不影响认证过程
- 测试方法：连上后左侧空白 → 看连接字符串末尾有没有
authSource=xxx，再核对用户实际创建库
SSL/TLS 开关必须和 MongoDB 实际配置严格一致
SSL 不匹配不会报明确错误，而是卡在握手阶段，表现为超时或无响应。
- 本地单机 MongoDB 默认未启用 TLS → Navicat 连接配置中必须 **关闭 SSL**（否则等 TLS 握手直到 timeout）
- MongoDB 7.0 自建服务若启用了 TLS（
net.ssl.mode: requireSSL），Navicat 需开启 SSL 并指定.pem路径 - 云服务（Atlas / 阿里云 / 腾讯云）全部强制 TLS → 必须勾选
Require SSL，部分还要求勾选Validate Certificate并导入 CA 证书（路径填/path/to/ca.pem） - 错误现象举例：
connection timeout、反复重连、连接测试按钮转圈无反馈 —— 先检查这个开关
Navicat 版本低于 16 无法稳定连接 MongoDB 7.0
MongoDB 7.0 引入了新的 wire protocol 特性与更严格的认证流程，旧版 Navicat（如 15.x）底层驱动不兼容，会出现登录成功但 collection 列表为空、聚合管道执行失败等问题。
- 最低要求：Navicat 16.0.14 或更高（2024 年后发布的版本基本都满足）
- 检查方式：菜单栏
Help → About Navicat，确认版本号；若低于 16，请升级而非降级 MongoDB - 别试图用 Navicat 12/15 + MongoDB 7.0 组合“凑合用”—— authSource 解析错、BSON 时间类型解析异常、$facet 聚合报错都是已知表现
真正卡住人的往往不是“连不上”，而是“连上了却像没连上”：空库列表、集合点不开、插入文档没反应。这些问题八成出在 authSource 和 SSL 开关这两个地方，而不是用户名密码本身。
