无法通过Metabase连接MongoDB，请求解读报错信息（SSH隧道正常）

嘿，作为经常折腾数据库连接问题的老玩家，我来帮你拆解下这类场景里最常出现的几种报错，以及背后的门道：

1. 「连接被拒绝」类报错 #

示例报错：com.mongodb.MongoSocketOpenException: Exception opening socket
或者 Connection refused: connect

哪怕你觉得SSH隧道配置没问题，也得再核对这几个细节：

• 本地SSH隧道的转发端口，是不是和Metabase里填写的MongoDB端口完全一致？比如你把远程MongoDB的27017转发到了本地27018，但Metabase里还填27017，肯定连不上。
• 远程MongoDB的绑定地址是不是仅限本地访问？很多MongoDB默认绑定127.0.0.1，这时候得改成绑定0.0.0.0（注意做好安全防护），或者确认隧道的本地接口被允许访问。
• 手动验证SSH隧道状态：用netstat -an | grep 你的本地转发端口或者lsof -i :本地端口，确认端口处于监听状态。

2. 「身份验证失败」类报错 #

示例报错：com.mongodb.MongoSecurityException: Exception authenticating MongoCredential

这类报错和SSH隧道本身无关，是MongoDB的权限问题：

• 核对Metabase里的MongoDB用户名、密码、认证数据库（默认是admin），是不是和远程MongoDB的配置完全匹配。
• 如果用的是MongoDB Atlas这类托管服务，要确认SSH隧道的出口IP是否被加入了MongoDB的IP白名单，同时检查该用户是否拥有目标数据库的读取权限。

3. 「连接超时」类报错 #

示例报错：com.mongodb.MongoSocketReadTimeoutException: Timeout while receiving message

通常是网络层面的延迟或限制导致：

• 检查SSH隧道的KeepAlive配置，有些服务器会自动断开长时间无活动的连接，可以在SSH配置里添加ServerAliveInterval 60来维持连接。
• 确认远程服务器的防火墙没有拦截MongoDB端口的流量，哪怕SSH能通，MongoDB的端口也可能被防火墙限制。
• 调大Metabase的连接超时设置：在数据库配置界面里找到超时选项，适当延长时间试试。

4. 「无效MongoDB URI」类报错 #

示例报错：Invalid MongoDB URI: 'mongodb://localhost:xxxx/xxx'

这是Metabase里的URI格式出错了：

• 确认URI里的端口是SSH转发的本地端口，而非远程MongoDB的原始端口。
• 如果MongoDB开启了SSL，URI末尾要加上?ssl=true（比如MongoDB Atlas通常需要这个配置）。

要是你能把具体的报错信息贴出来，我还能更精准地帮你定位问题！

内容的提问来源于stack exchange，提问作者Kevin Sedgley