搭建Node.js云API服务器时，如何解决max_user_connections引发的崩溃问题？

核心原因 #

虽然数据库max_user_connections设为30，但你的代码大概率存在数据库连接泄漏——每次请求新建连接后没有正确释放，导致连接数快速耗尽，触发服务器崩溃。

解决方案 #

1. 改用数据库连接池管理连接

不要每次请求都创建新连接，使用连接池复用连接，既避免频繁创建/销毁连接的开销，又能自动控制连接数。以MySQL为例（使用mysql2库）：

• 安装依赖：npm install mysql2
• 初始化连接池，连接数设为略小于数据库max_user_connections（比如25）：

const mysql = require('mysql2/promise');

const pool = mysql.createPool({
  host: '你的数据库地址',
  user: '数据库用户名',
  password: '数据库密码',
  database: '目标数据库',
  connectionLimit: 25,
  waitForConnections: true,
  queueLimit: 0
});

2. 确保连接使用后正确释放

在API请求处理中，从连接池获取连接，操作完成后（无论成功/失败）都要释放回池，用try/finally保证释放逻辑必执行：

app.post('/api/your-endpoint', async (req, res) => {
  let connection;
  try {
    // 从连接池获取连接
    connection = await pool.getConnection();
    // 执行数据库读写操作
    const [result] = await connection.query('INSERT INTO your_table SET ?', req.body);
    res.json({ success: true, insertId: result.insertId });
  } catch (err) {
    console.error('DB操作失败:', err);
    res.status(500).json({ error: '服务器内部错误' });
  } finally {
    // 无论是否出错，都释放连接回池
    if (connection) connection.release();
  }
});

3. 排查代码中的连接泄漏点

• 检查是否使用了createConnection而非连接池：这种方式每次请求新建连接，若忘记调用connection.end()会导致连接一直占用。
• 确认异步操作是否正确await：如果数据库查询没加await，代码会提前返回，连接没来得及释放。
• 检查错误分支：如果请求处理中抛出错误但没在catch里释放连接，也会导致泄漏。

4. 验证连接数状态

可以在数据库中执行SHOW PROCESSLIST;查看当前活跃连接数，确认是否是连接耗尽导致的崩溃。如果连接数持续增长到30，说明确实是泄漏问题。

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