DBeaver连接远程PostgreSQL数据库超时但psql可连如何排查

1. DBeaver客户端配置排查 #

• 核对基础连接参数：确认填写的远程主机IP、端口、数据库名、用户名密码，和远程主机上psql连接使用的参数完全一致，重点排查是否误填自定义端口、是否错误开启了未配置的SSH隧道/SSL选项。
• 调整连接超时阈值：右键对应连接选择「编辑连接」->「编辑驱动设置」，将*连接超时（秒）*参数调整到30以上再重试，DBeaver默认超时阈值远低于psql，高延迟网络下很容易触发超时。
• 校验JDBC驱动兼容性：如果DBeaver使用的PostgreSQL JDBC驱动版本和远程服务端大版本差异过大，会出现连接异常，可在驱动管理中更新到和服务端版本匹配的JDBC驱动。
• 排查本地拦截规则：确认DBeaver没有被客户端主机的防火墙、安全软件拦截出站请求，同时检查DBeaver是否配置了全局代理，代理规则不允许访问远程数据库端口也会导致连通性差异。

2. 远程服务端配置排查 #

• 检查pg_hba.conf访问规则：

psql在远程主机本地执行时，默认走Unix域套接字或者127.0.0.1的访问规则，不需要开放外部IP访问权限，和DBeaver远程访问走的是完全不同的校验链路。
需要确认pg_hba.conf中是否添加了DBeaver所在客户端IP的放行规则，配置修改后需要重启PostgreSQL服务生效。

• 核对远程端口放行规则：确认远程主机的系统防火墙（iptables/firewalld）、云服务商安全组，已经放行了DBeaver所在IP的数据库端口（默认5432）入站请求。
• 排查连接限制规则：确认PostgreSQL没有设置针对外部IP的连接数限制、频率限制，短时间多次连接失败可能触发临时封禁规则。

3. 网络链路排查 #

• 在DBeaver所在的客户端主机执行telnet 远程IP 数据库端口或nc -zv 远程IP 数据库端口，测试端口连通性，如果不通说明是网络链路问题，和数据库配置无关。
• 测试网络质量：执行ping 远程IP、mtr 远程IP检查链路丢包率、延迟，丢包率超过10%的不稳定链路很容易触发DBeaver的超时判定。
• 确认端口映射规则：如果远程PostgreSQL是通过端口映射对外暴露的，需要确认映射规则对非本地来源的IP生效，没有配置仅允许本地IP访问映射端口的限制。

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