Node.js连接MySQL时连接池多连接及空闲连接未关闭问题咨询

问题汇总 #

• 使用Node.js的mysql库连接池，运行前端项目后执行SHOW PROCESSLIST，发现数据库中有5-6个连接，这种情况是否正常？是否应该仅存在一个连接？
• 若多连接属于正常情况，为何不需要这些连接时它们不关闭？本可仅保留一个空闲连接以避免昂贵的重连操作，为何会有多个空闲连接持续存在？
• 日志显示连接已通过release事件释放，但数据库中这些连接仍处于“SLEEP”模式，这是为什么？

配置与代码参考 #

连接池配置：

const dbConfig = {
  timezone: "+05:30",
  host: "host",
  user: "user",
  password: "pwd",
  database: "db_name",
  port: 3306,
  connectionLimit: 30,
  multipleStatements: true,
  acquireTimeout: 10000, 
  idleTimeout: 3000,  
  waitForConnections: true, 
};

连接释放监听：

pool.on('release', function (connection) {
  console.log('Connection %d released', connection.threadId);
});

查询函数：

function query(sql, args, writeLog) {
  return new Promise((resolve, reject) => {
    pool.getConnection((err, conn) => {
      if (err) {
        console.trace(err);
        return reject(err);
      }
      try {
        conn.query('SET SESSION wait_timeout = 120', (err) => {
          console.log("wait timeout");
          if (err) {
            console.error('Error setting session wait_timeout:', err);
          }
        });

        conn.query('SET SESSION interactive_timeout = 120', (err) => {
          console.log("interactive_timeout");
          if (err) {
            console.error('Error setting session interactive_timeout:', err);
          }
        });

        conn.query(sql, args, (err1, rows) => {
          if (err1) {
            console.trace(err1);
            return reject(err1); 
          }
          if (writeLog) {
            writeLog(sql, args);
          }
          resolve(rows);
        });
      } finally {
        conn.release();
      }
    });
  });
}

解答 #

1. 多空闲连接是正常现象
   连接池的核心作用就是预保留一定数量的空闲连接，避免每次请求都重新建立数据库连接（TCP握手、权限验证等操作开销很大）。你看到的处于“SLEEP”状态的连接，就是连接池里的空闲连接，等待下一次请求复用，这完全符合连接池的设计逻辑，属于正常情况，不需要纠结“仅保留一个连接”。

2. 为什么不关闭多余空闲连接？

• 你的配置中idleTimeout: 3000（3秒），理论上连接放回池后如果3秒内没有被复用，连接池会自动关闭这个连接。但如果你的应用有持续的请求，连接会被反复复用，自然不会被关闭。
• 你在每个连接里执行了SET SESSION wait_timeout = 120和SET SESSION interactive_timeout = 120，这会让连接在数据库端保持120秒的空闲存活时间，但这和连接池的回收逻辑不冲突——连接池判断是否关闭连接看的是自己的idleTimeout，不是数据库的会话超时。
• 你的connectionLimit设为30，当前5-6个连接远低于上限，连接池不会主动关闭空闲连接，因为保留这些连接能更快响应后续请求。

3. 日志显示释放但数据库仍SLEEP的原因
   conn.release()不是关闭连接，而是把连接从“被占用”状态放回连接池的空闲队列，对应数据库里的状态就是“SLEEP”。只有当连接池判定这个连接不需要了（比如超过idleTimeout未被复用，或者需要降低连接数），才会调用conn.destroy()真正关闭连接，这时SHOW PROCESSLIST里对应的进程才会消失。你看到的release日志只是连接回到了池里，不是被关闭。

4. 代码里的小问题提醒
   你的query函数中，conn.release()放在finally块是正确的，但要注意：SET SESSION的两个查询是异步操作，你在finally里直接release，可能这些会话设置还没执行完就把连接放回池了。虽然不会导致连接池异常，但建议改成async/await风格，确保会话设置完成后再处理主查询，比如：

async function query(sql, args, writeLog) {
  const conn = await pool.getConnection();
  try {
    await conn.query('SET SESSION wait_timeout = 120');
    await conn.query('SET SESSION interactive_timeout = 120');
    const rows = await conn.query(sql, args);
    if (writeLog) writeLog(sql, args);
    return rows;
  } catch (err) {
    console.trace(err);
    throw err;
  } finally {
    conn.release();
  }
}

另外，接口中使用的queryEngine.query看起来和你定义的Promise版query不是同一个，要确保它也是正确使用连接池释放连接的，避免出现连接泄漏。

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