08001: sqlclient_unable_to_establish_sqlconnection

含义

客户端无法与 PostgreSQL 服务器建立连接。连接在成为会话之前，就在网络/地址层面失败了。

原因

主机/端口错误；服务器没有在该地址上监听（listen_addresses = 'localhost' 时从远程连接）；服务器宕机/不可达；防火墙阻止了端口（默认 5432）；或 DNS 解析失败。配置错误的连接池也可能触发。

解决方法

确认服务器已启动并在正确的地址上监听：检查 postgresql.conf 中的 listen_addresses = '*'（或相应 IP）和端口设置，然后重启服务器（listen_addresses 和 port 需要重启；reload 不够）。从客户端测试访问：psql -h host -p 5432 -U app_user。在防火墙中开放 5432/tcp。检查 host/port/DNS 值和连接字符串。