// PostgreSQL 错误参考

PostgreSQL 08006:连接失败

使用过程中与服务器的连接断了。服务器进程结束、重启或被杀,或者网络断掉了空闲连接。

SQLSTATE
08006
名称
connection_failure
类别
连接异常
错误信息
server closed the connection unexpectedly
	This probably means the server terminated abnormally
	before or while processing the request.

它的意思

08006 是客户端代码:当已建立的连接在通信过程中失败时,驱动程序会报告它。服务器无法通过已失效的连接发送错误,因此该消息来自客户端库。基于 libpq 的工具(psql、psycopg)会打印上述消息,而 PgJDBC 会报告 SQLSTATE 08006,并显示 An I/O error occurred while sending to the backend.

服务器日志通常会解释原因:后端崩溃并重启、内存不足导致的进程终止、管理员终止会话,或者当防火墙或负载均衡器悄悄地断开空闲 TCP 连接时,可能完全没有记录。

常见原因

  • 会话对应的服务器进程崩溃或被杀,通常是操作系统的 OOM Killer 所致,这会使 PostgreSQL 重启所有会话。
  • 服务器已重启或发生故障切换。
  • 防火墙、NAT 网关或云负载均衡器丢弃了空闲时间超过其超时设置的连接。
  • 会话已被终止,由 pg_terminate_backend() 或空闲超时,而客户端要到下一次查询才会察觉。

如何修复它

  1. 检查故障发生时间前后的服务器日志,查找 terminated by signal, server process ... was terminated,或者重启。

  2. 如果空闲连接被网络断开,请在服务器(或客户端)上启用 TCP 保活,让连接永远不会被当作空闲。

    ALTER SYSTEM SET tcp_keepalives_idle = 60;
    ALTER SYSTEM SET tcp_keepalives_interval = 10;
    ALTER SYSTEM SET tcp_keepalives_count = 6;
    SELECT pg_reload_conf();
  3. 配置连接池在分发连接前先验证或回收连接,并在安全的前提下用新连接重试一次操作。

  4. 如果服务器内存耗尽,请找出占用内存的查询,并调低 work_mem 或并发连接数。

相关错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。