PostgreSQL连接失败排查与优化全攻略

1. PostgreSQL连接失败问题深度解析

遇到"connection to server at '1', port 5432 failed"错误时，作为DBA最常检查的五个关键点依次是：服务状态、网络配置、认证配置、资源限制和日志追踪。这个报错表面看是连接问题，实则可能涉及PostgreSQL服务全栈配置。

1.1 错误信息拆解

典型错误信息包含三个关键要素：

• 目标地址：示例中的'1'可能是主机名/IP解析异常
• 端口号：5432是PostgreSQL默认端口
• 失败原因：未明确提示但常见于密码错误或服务未启动

通过systemctl status postgresql查看服务状态时，健康状态应显示"active (running)"，如果看到"inactive (dead)"就需要进一步排查启动日志。

2. 全链路排查方案

2.1 服务状态检查

在Ubuntu系统上使用以下命令序列：

bash复制# 检查服务运行状态
sudo systemctl status postgresql

# 尝试重启服务
sudo systemctl restart postgresql

# 查看启动日志
journalctl -u postgresql -b --no-pager | tail -20

如果发现服务无法启动，重点检查：

1. /var/lib/postgresql/版本号/main/postmaster.pid 是否残留旧进程
2. /etc/postgresql/版本号/main/postgresql.conf 中的监听配置
3. 磁盘空间是否充足（df -h /var/lib/postgresql）

2.2 网络连接验证

使用telnet进行基础连通性测试：

bash复制telnet localhost 5432

如果连接被拒绝，检查postgresql.conf关键参数：

conf复制listen_addresses = 'localhost'  # 生产环境建议绑定具体IP
port = 5432                    # 确认端口未被修改

同时检查pg_hba.conf的认证规则：

conf复制# 允许本地密码认证
host