PostgreSQL托管服务闲置后自动断连问题求解

1. 给node-postgres连接池配置闲置回收+心跳机制 #

托管服务商普遍默认设置了5-7分钟的闲置连接超时，与其被动等待连接断开，不如让连接池主动管理：

• 将idleTimeoutMillis设为短于服务商的超时时间（比如4分钟=240000毫秒），让连接池提前回收即将被平台断开的闲置连接
• 启用keepAlive并设置初始延迟，定期发送简单心跳查询（如SELECT 1;）维持连接活跃

代码示例：

const { Pool } = require('pg');
const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
  idleTimeoutMillis: 240000, // 4分钟，短于服务商的超时阈值
  keepAlive: true,
  keepAliveInitialDelayMillis: 30000, // 启动30秒后开始发送心跳
});

// 可选：连接建立后立即发送一次心跳，确保连接状态正常
pool.on('connect', (client) => {
  client.query('SELECT 1;');
});

2. 调整服务商的连接超时配置 #

换服务商后问题依旧，但多数托管平台允许在控制台修改闲置连接超时：

• Supabase：在数据库设置中找到「连接池」或「闲置连接超时」选项，尝试延长超时时间（注意部分套餐有上限）
• bit.io：查看数据库实例的连接配置面板，调整闲置连接的回收阈值

3. 针对连接终止错误做精准重试 #

不用全局拦截，直接在查询逻辑里捕获PostgreSQL标准的连接终止错误码（57P01）进行重试：

async function runQuery(query) {
  let client;
  try {
    client = await pool.connect();
    return (await client.query(query)).rows;
  } catch (err) {
    // 只针对连接终止的特定错误重试
    if (err.code === '57P01') {
      if (client) client.release(true); // 标记该连接失效，避免放回连接池
      return runQuery(query); // 重试一次即可，避免死循环
    }
    throw err;
  } finally {
    if (client) client.release();
  }
}

4. 避免长期持有单个连接 #

不要将数据库客户端实例全局复用，每次操作都从连接池获取连接，使用完毕后立即释放。依赖连接池的自动管理，不要手动长期持有连接。

内容的提问来源于stack exchange，提问作者Luka Fridonich Donadze