Node.js+pg连接池未自动释放连接：设置connectionTimeoutMillis无效

DevOps 小满

2026-8-18

node-postgres中connectionTimeoutMillis的理解误区解析

你完全搞混了connectionTimeoutMillis的作用，它根本不是用来自动释放已持有连接的，具体说明如下：

connectionTimeoutMillis的真实作用：这个参数控制的是当你从连接池请求客户端时，如果池里没有可用的闲置连接，等待新连接创建的超时时间。比如设为1000，就是拿连接时最多等1秒，超时就抛出错误，和已拿到手的客户端会不会自动释放一点关系都没有。
为什么你的连接一直闲置？因为你没调用client.release()，这个客户端就一直被你的代码持有，不会回到连接池，PostgreSQL那边自然会显示这个连接处于活跃/闲置状态（取决于有没有执行过查询）。连接池根本没机会回收它，更别说自动释放了。
真正控制闲置连接自动释放的参数是idleTimeoutMillis，但有个前提：这个客户端必须已经被release()放回连接池，处于闲置状态后，才会在等待idleTimeoutMillis设置的时间后被连接池销毁，进而释放对应的PostgreSQL连接。

举个正确的使用示例：

const { Pool } = require('pg');

const pool = new Pool({
  user: 'your_user',
  host: 'localhost',
  database: 'your_db',
  password: 'your_password',
  port: 5432,
  connectionTimeoutMillis: 1000, // 请求连接时的等待超时
  idleTimeoutMillis: 1000        // 池内闲置连接1秒后自动销毁
});

async function runQuery() {
  const client = await pool.connect();
  try {
    const result = await client.query('SELECT 1');
    console.log(result.rows);
  } finally {
    // 必须调用release，把客户端放回池，才能触发idleTimeoutMillis的销毁逻辑
    client.release();
  }
}

runQuery();

总结核心点：