Spring Boot项目对接Azure PostgreSQL执行Copy导入时连接断开求助

根因初步定位 #

从日志中的FATAL: terminating connection due to administrator command和socket操作报错可以直接判定，是Azure侧的服务端组件主动断开连接，而非Hikari连接池主动回收。本地运行正常的核心原因是本地环境没有云厂商PaaS数据库前置的网关层超时限制。

具体排查与解决步骤 #

• 确认Azure Postgres网关层超时配置 #

  Azure PaaS Postgres实例前置有官方网关组件，默认空闲连接超时为4分钟，该配置独立于数据库内核的idle_in_transaction_session_timeout、statement_timeout参数，仅调整数据库内核参数不会生效：
  1. 若使用单服务器版实例：网关超时固定为4分钟，无法调整
  2. 若使用灵活服务器版实例：可在门户实例配置页的「连接」设置中，将TCP空闲超时调整到最长30分钟

• 调整PostgreSQL JDBC连接参数 #

  在JDBC连接串中新增以下配置，开启TCP保活机制避免网关判定连接空闲：

  jdbc:postgresql://<实例地址>:5432/<库名>?tcpKeepAlive=true&socketTimeout=1800000&tcpKeepAliveIdle=30
  

  注：tcpKeepAliveIdle参数控制每隔30秒发送一次TCP保活包，避免网关认为连接无流量主动断连

• 修正Hikari连接池配置 #

  你当前所有Hikari超时参数均为注释状态，使用默认值，需要调整为以下配置，避免连接池持有已被服务端断开的死连接：

  hikari:
    auto-commit: false
    poolName: Hikari
    # 保证连接最大生命周期比网关超时短1~2分钟，此处以网关超时4分钟为例，设为3分钟
    maxLifetime: 180000
    # 每次拿连接时校验连接有效性
    connection-test-query: SELECT 1
    validation-timeout: 3000
  

• 优化COPY操作逻辑 #

  400万行数据不要一次性提交COPY，可拆分每10~20万行执行一次COPY IN并提交事务，避免单操作持有连接时间过长触发断连

• 确认数据库参数生效 #

  登录Azure Postgres实例执行以下SQL，确认调整的超时参数确实已生效：

  show idle_in_transaction_session_timeout;
  show statement_timeout;
  

  若参数未生效，检查参数组是否已绑定到当前实例，且已执行实例重启操作。

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