PostgreSQL客户端工具连接时显示“connection refused”，如何排查与解决？

Question

当使用PostgreSQL客户端工具连接数据库时，若遇到“connection refused”错误，通常表明客户端无法与服务器建立连接。以下是排查与解决的常见步骤： 1. **确认PostgreSQL服务是否运行**：检查服务器上的PostgreSQL服务是否已启动。可以使用`systemctl status postgresql`或`pg_isready`命令验证。 2. **检查监听地址配置**：确保`postgresql.conf`文件中`listen_addresses`设置为`'*'`或指定IP，允许外部连接。 3. **验证端口是否开放**：默认情况下，PostgreSQL使用5432端口。通过`netstat -an | grep 5432`确认端口是否正在监听，并检查防火墙规则（如`iptables`或安全组）是否阻止了该端口。 4. **审查访问控制**：检查`pg_hba.conf`文件，确保客户端IP地址被正确授权访问。 5. **测试网络连通性**：使用`telnet`或`nc`命令测试从客户端到服务器的端口连通性。 如果以上步骤均正常，可尝试重启PostgreSQL服务并查看日志文件（如`/var/log/postgresql/`）以获取更多信息。

Answer 1

1. 初步排查：确认PostgreSQL服务状态

当遇到“connection refused”错误时，首要任务是确认PostgreSQL服务是否正常运行。以下是具体步骤：

• 使用命令 systemctl status postgresql 检查服务状态。
• 或者运行 pg_isready 命令验证数据库是否接受连接。

如果服务未启动，可以尝试使用以下命令启动服务：

sudo systemctl start postgresql

2. 配置检查：监听地址与端口设置

接下来需要检查PostgreSQL的配置文件以确保其正确设置。

1. 打开 postgresql.conf 文件，查找 listen_addresses 参数。
2. 将该参数设置为 '*' 或指定服务器IP地址。

同时验证5432端口是否开放：

netstat -an | grep 5432

若端口未监听，需重新配置并重启服务。

3. 安全性分析：防火墙与访问控制

即使端口已开放，防火墙规则或安全组仍可能阻止外部连接。

检查项	操作
防火墙规则	运行 iptables -L 查看规则列表。
云平台安全组	登录云管理控制台，添加允许5432端口的入站规则。

此外，检查 pg_hba.conf 文件，确保客户端IP被授权：

host all all 0.0.0.0/0 md5

4. 网络测试：连通性验证

通过网络工具验证客户端到服务器的连通性：

telnet <server_ip> 5432

或者使用 nc 工具：

nc -zv <server_ip> 5432

如果无法连接，请进一步检查路由和网络配置。

5. 综合解决：日志分析与服务重启

若上述步骤均无误，可尝试重启PostgreSQL服务并查看日志：

sudo systemctl restart postgresql

日志路径通常位于 /var/log/postgresql/，可通过以下命令查看：

tail -f /var/log/postgresql/postgresql-*.log

结合日志信息定位潜在问题。

流程图：排查步骤总结