pgAdmin4连接PostgreSQL出现SSL SYSCALL超时问题如何解决？

你遇到的SSL SYSCALL超时不是PostgreSQL服务端的会话超时导致的（已确认statement_timeout、idle_in_transaction_session_timeout两个参数都为0），绝大多数情况是客户端和服务端之间的网络设备（如防火墙、路由器、负载均衡）检测到空闲TCP连接超过阈值后主动切断了链路，60秒是很多网络设备默认的空闲连接回收阈值，可通过以下方案解决：

• 调整PostgreSQL服务端TCP保活参数
  开启TCP保活包机制，让服务端定期向客户端发送小包维持连接活跃，避免被网络设备回收，需要配置3个核心参数：

  # postgresql.conf 新增/修改以下配置
  tcp_keepalives_idle = 30   # 连接空闲30秒后开始发送保活包，低于60秒的切断阈值
  tcp_keepalives_interval = 10 # 保活包发送间隔10秒
  tcp_keepalives_count = 3    # 连续3次无响应则判定连接失效
  

  修改完成后执行SELECT pg_reload_conf();重载配置即可生效，无需重启数据库。可以执行SHOW tcp_keepalives_idle;确认配置是否生效。
• 调整pgAdmin4客户端连接配置
  适配无法修改服务端配置的场景，直接在pgAdmin侧开启保活即可：
  1. 打开pgAdmin4的设置界面，找到「Connection」（连接）分类
  2. 开启「TCP keepalives」选项，分别将「Keepalive idle」设为30、「Keepalive interval」设为10
  3. 也可以在对应数据库连接的高级属性中，新增参数keepalives=1、keepalives_idle=30单独配置该连接的保活规则
     额外优化建议：pgAdmin4 5.7版本存在已知的SSL连接保活失效问题，可升级到6.0及以上的稳定版本规避该bug。
• 临时规避方案（无需调整配置）
  暂时无法修改两端配置时，可通过以下方式避免连接断开导致临时表丢失：
  1. 每间隔50秒手动执行一次轻量查询SELECT 1;，主动维持会话活跃
  2. 将需要长期使用的临时表替换为UNLOGGED普通表，该类表写入性能接近临时表，且重连不会丢失数据，适合替代会话级临时表的使用场景
• 检查中间链路配置
  如果是通过SSL隧道、VPN、云数据库代理访问PostgreSQL，需要额外检查中间链路的闲置超时配置，将阈值调大到60秒以上，或者开启对应链路的TCP保活功能。

内容的提问来源于stack exchange，提问作者hsnsd