执行含30万条数据的SQL脚本时遇SSL SYSCALL错误：EOF detected如何解决？

针对执行30万行插入脚本时出现的ERROR: SSL SYSCALL error: EOF detected错误，以下是几个实用的解决方向：

1. 调整超时相关配置 #

• pgAdmin端：打开连接属性，将「连接超时」和「命令超时」的数值调大（比如设置为3600秒），避免工具主动断开长时间运行的会话。
• PostgreSQL服务器端：修改postgresql.conf中的参数：
  • 增大ssl_timeout（默认600秒，可改为3600秒），延长SSL连接的超时时间；
  • 调整tcp_keepalives_idle和tcp_keepalives_interval（比如分别设为300秒和60秒），让TCP层定期发送保活包，防止中间防火墙断开无数据传输的连接。
    修改后重启PostgreSQL服务生效。

2. 拆分批量插入，避免单事务过大 #

一次性插入30万行会导致单事务体积过大、执行时间过长，更容易触发超时。建议分批插入并每批提交：

DO
LANGUAGE plpgsql
$BLOCK$
DECLARE
  batch_size INT := 1000; -- 每批插入行数，可根据服务器性能调整
  total_rows INT := 300000;
  current_offset INT := 0;
BEGIN
  WHILE current_offset < total_rows LOOP
    INSERT INTO your_table (col1, col2, ...)
    -- 替换为你的数据源逻辑，比如从临时表读取或生成数据
    SELECT gen_col1(), gen_col2(), ...
    LIMIT batch_size OFFSET current_offset;
    
    current_offset := current_offset + batch_size;
    COMMIT; -- 每批提交，释放事务资源
  END LOOP;
EXCEPTION
  WHEN OTHERS THEN
    ROLLBACK;
    RAISE;
END
$BLOCK$;

如果是从外部文件导入数据，优先使用COPY命令，它的执行效率远高于批量INSERT，能大幅缩短执行时间：

COPY your_table (col1, col2, ...) FROM '/path/to/your/data.csv' WITH (FORMAT csv, HEADER);

注意确保PostgreSQL服务对目标文件有读取权限，也可以用pgAdmin自带的「导入/导出数据」工具，底层基于COPY实现，稳定性更好。

3. 排查网络与SSL配置 #

• 如果是远程连接，检查中间的防火墙、代理或VPN是否有会话超时限制，这类设备常断开长时间无数据交互的连接；
• 临时尝试关闭SSL连接：在pgAdmin的连接设置中把「SSL模式」改为「禁用」，若错误消失，说明问题出在SSL层，可进一步检查证书有效性、SSL版本兼容性，或更新服务器端的OpenSSL版本；
• 调整服务器端ssl_ciphers配置，避免使用易被中断的加密套件。

4. 优化插入性能，缩短执行时间 #

通过减少插入时的额外开销，让操作更快完成：

• 插入前临时禁用目标表的触发器和索引，完成后再恢复：

-- 禁用触发器和索引
ALTER TABLE your_table DISABLE TRIGGER ALL;
DROP INDEX IF EXISTS idx_your_table_col1;

-- 执行插入操作

-- 恢复触发器和重建索引
ALTER TABLE your_table ENABLE TRIGGER ALL;
CREATE INDEX idx_your_table_col1 ON your_table (col1);

• 调整PostgreSQL性能参数，比如增大work_mem（提升排序/哈希操作内存）、maintenance_work_mem（提升索引重建效率），进一步加快批量插入速度。

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