MongoDB 连接失败主因是连接字符串格式错误、authSource配置不当、SSL/TLS开关不匹配及Navicat版本兼容问题；需严格使用mongodb://开头、URL编码密码、正确设置authSource、按环境启停SSL，并使用Navicat 16+适配新版本MongoDB。
MongoDB 连接失败：检查 mongodb:// 连接字符串格式
navicat 对 mongodb 的连接依赖标准的 uri 格式，不是填个 ip 和端口就能通。漏掉协议头、错用斜杠、混用用户名密码位置，都会直接报 failed to connect to server 或 authentication failed。
- 必须以
mongodb://开头（不是mongo://，也不是http://） - 用户名密码需 URL 编码 —— 比如密码含
@、/、:，不编码就会被解析成 host 或 port - 若使用副本集，要写全多个 host，用逗号分隔，末尾加
?replicaSet=xxx，不能只填一个节点还指望自动发现 - 本地默认端口是
27017，但 Docker 或云服务（如 MongoDB Atlas）常改用27017以外的端口，务必确认
示例正确格式：mongodb://admin:pass%40123@192.168.1.10:27017/admin?authSource=admin
认证数据库（authSource）填错导致登录成功但看不到库
Navicat 登录时能弹出“连接成功”，但左侧数据库列表为空，大概率是 authSource 设错了。MongoDB 的用户是绑定在某个数据库上的（通常是 admin），但 Navicat 默认用你填的“数据库名”做认证源，而不是用户实际所在的库。
- 如果用户是在
admin库里创建的（绝大多数生产环境如此），连接参数里必须显式指定authSource=admin - 不要把“数据库名”字段（Navicat 界面里的 “Database” 输入框）和
authSource混为一谈 —— 前者决定你连上去默认打开哪个库，后者决定去哪验证身份 - 云服务（如 Atlas）强制要求
authSource=$external且开启 TLS，这个值不能手填错，否则连上也列不出 collections
SSL/TLS 开关不匹配：连不上或提示 connection timeout
本地单机 MongoDB 默认不启用 SSL；但 Atlas、阿里云 MongoDB、腾讯云 TDMQ for MongoDB 等全部强制 TLS，且证书校验严格。Navicat 里一个开关没对上，就会卡在握手阶段，表现为超时而非明确报错。
- 本地测试：关闭
SSL选项（Navicat 连接配置页底部），否则会等 TLS 握手直到超时 - 云服务：必须开启
SSL，且选Require SSL；部分服务商（如 Atlas Free Tier）还要求勾选Validate Certificate并导入 CA 证书（路径填/path/to/ca.pem） - 自建 MongoDB 启用了 TLS？那得确保 Navicat 能读取你的
.pem文件，且服务端配置了net.ssl.mode: requireSSL
Navicat 版本与 MongoDB 兼容性：别用太老的客户端连新版本
Navicat 15 及更早版本对 MongoDB 5.0+ 的新特性（如 $expr 在聚合中更宽松的语法、SCRAM-SHA-256 认证机制）支持不完整，可能连得上但执行查询时报 Command not supported 或直接断连。
- 推荐用 Navicat 16 或更新版 —— 官方明确标注支持 MongoDB 6.0+
- 如果你用的是 MongoDB 4.4+ 且启用了
SCRAM-SHA-256（新安装默认开启），旧版 Navicat 可能只认SCRAM-SHA-1，此时要么降级认证机制（不推荐），要么升级客户端 - 不确定版本兼容性？先在命令行用
mongosh连一下，确认服务本身没问题，再排查 Navicat 配置
真正麻烦的从来不是填几个字段，而是错误信息不指向真实原因 —— 比如显示“连接超时”，实际是 SSL 开关反了；显示“认证失败”，其实是 authSource 指向了空库。多看一眼连接字符串里的每个参数，比反复点“测试连接”有用得多。
