pgAdmin4添加新服务器时出现connection timeout expired问题求助

排查与修复步骤 #

• 确认PostgreSQL服务状态
  打开系统服务管理器（Windows可通过执行services.msc命令打开），找到PostgreSQL相关服务，检查是否处于「正在运行」状态。若未启动，右键选择「启动」，并设置启动类型为「自动」，避免重启系统后服务停止。

• 修改PostgreSQL监听配置
  找到PostgreSQL安装目录下data文件夹中的postgresql.conf文件，修改listen_addresses参数为*（允许所有IP地址访问），或者指定pgAdmin所在机器的具体IP。修改完成后，必须重启PostgreSQL服务使配置生效。

• 测试端口连通性
  使用命令行工具测试端口是否可访问：

  • Windows：执行telnet 服务器IP 5432（默认端口为5432，若修改过端口请替换）
  • Linux/macOS：执行nc -zv 服务器IP 5432
    如果命令执行失败，说明端口可能被其他进程占用，或PostgreSQL未正确监听该端口。

• 核对pgAdmin连接参数
  在「添加新服务器」页面确认以下信息：

  • 「主机名/地址」：填写PostgreSQL服务器的正确IP，本地服务器可尝试127.0.0.1代替localhost，规避DNS解析异常
  • 「端口号」：与postgresql.conf中port参数一致（默认5432）
  • 「维护数据库」：默认填写postgres即可

• 排查网络环境限制

  • 若连接远程服务器，需确认服务器端的安全组/防火墙规则是否开放了对应端口
  • 若连接本地虚拟机，检查虚拟机网络模式（如桥接、NAT）是否允许主机与虚拟机互通

内容的提问来源于stack exchange，提问作者Trường Phan Văn