面对 Node.js 数据库连接池耗尽，最稳妥的方向是先调整连接池配置参数限制等待时间，再配合应用层请求排队，避免无限阻塞导致服务雪崩。

快速处理思路

这类问题通常没有单行命令能解决，需要修改代码配置。以下是常见数据库客户端的调整方向：

// PostgreSQL (node-postgres)
const pool = new Pool({
  max: 20, // 根据数据库最大连接数调整
  acquireTimeoutMillis: 5000, // 获取连接超时，防止无限等待
  idleTimeoutMillis: 30000
});

// MySQL (mysql2/promise)
const pool = mysql.createPool({
  connectionLimit: 20,
  acquireTimeout: 5000, // 注意：不同版本行为可能不同，建议结合测试
  timeout: 30000
});

为什么会这样

Node.js 是单线程事件循环模型，但数据库连接是外部有限资源。当并发请求数超过连接池最大数量（max）时，新请求会进入等待队列。如果数据库处理慢或者连接没释放，等待队列会越来越长，最终导致获取连接超时（TimeoutError）。

很多默认配置没有设置获取超时时间，导致请求一直挂着，占用内存且不返回结果，看起来像服务卡死。

分步处理

1. 检查当前连接池状态
查看应用日志是否有 "timeout" 或 "connection limit exceeded" 错误。如果是 PostgreSQL，可以在数据库侧执行以下 SQL 查看活跃连接：

-- PostgreSQL 查看当前数据库活跃连接数
SELECT count(*) FROM pg_stat_activity WHERE datname = 'your_database_name';

-- MySQL 查看当前连接数
SHOW STATUS LIKE 'Threads_connected';

2. 调整客户端配置并捕获超时
找到初始化连接池的代码，显式设置 acquireTimeout（或 acquireTimeoutMillis）。建议设置为业务可接受的最大等待时间，例如 3 秒到 5 秒。务必包裹 try-catch 处理超时错误：

try {
  const client = await pool.connect();
  try {
    await client.query('SELECT * FROM users');
  } finally {
    client.release(); // 确保释放连接
  }
} catch (err) {
  if (err.message.includes('timeout')) {
    console.error('获取连接超时，可能连接池已满');
    // 返回友好错误或触发降级逻辑
  }
  throw err;
}

3. 引入应用层排队（核心优化）
如果数据库连接数无法增加，可以使用 p-queue 等库在应用层控制并发，让多余请求在应用层排队而不是占满数据库连接池等待。以下是集成示例：

import PQueue from 'p-queue';

// 初始化队列，并发数略小于连接池 max 值
const queue = new PQueue({ concurrency: 15 });

// 包装数据库查询函数
async function safeQuery(queryText) {
  return queue.add(async () => {
    const client = await pool.connect();
    try {
      return await client.query(queryText);
    } finally {
      client.release();
    }
  });
}

// 使用时直接调用 safeQuery
app.get('/data', async (req, res) => {
  try {
    const result = await safeQuery('SELECT * FROM data');
    res.json(result);
  } catch (e) {
    res.status(503).send('Service Busy');
  }
});

4. 检查连接释放
确保所有查询都正确 await 或在回调中释放连接，避免事务未提交导致连接占用。

怎么验证是否生效

1. 日志观察
监控应用错误日志，确认 "Timeout acquiring client" 类错误是否不再持续激增。

2. 数据库监控
查看数据库监控面板，活跃连接数（Active Connections）应稳定在配置的最大值附近，而不是持续飙升直到数据库拒绝连接。

3. 响应时间
部分请求可能会因为超时快速失败，整体平均响应时间可能会波动，但不再出现大面积请求挂起。

常见坑

1. 盲目调大 max 值
连接池的 max 不能超过数据库允许的最大连接数，否则会导致数据库侧报错甚至崩溃。

2. 忘记设置超时
如果不设置 acquireTimeout，请求会无限等待，直到内存耗尽或重启。

3. 事务未提交
长事务会独占连接，导致连接池迅速耗尽，检查代码中是否有未关闭的事务。

4. 版本兼容性
mysql2 的 acquireTimeout 参数在不同版本中行为可能不同，生产环境升级前务必验证超时机制是否按预期触发。

参考来源

• node-postgres Documentation - Pool Properties, https://github.com/brianc/node-postgres
• node-mysql2 Documentation - Pool Options, https://github.com/sidorares/node-mysql2
• p-queue Documentation, https://github.com/sindresorhus/p-queue