node-mysql2连接池使用指南：解决"Can't add new command when connection is closed"错误

在使用node-mysql2连接MariaDB/MySQL数据库时，开发者经常会遇到"Can't add new command when connection is in closed state"的错误提示。这个错误通常表明应用程序尝试在一个已经关闭的数据库连接上执行查询操作。本文将深入分析这个问题的成因，并提供最佳实践解决方案。

错误原因分析

这个错误的本质是连接状态管理问题。当数据库连接由于以下原因被关闭后，应用程序仍然尝试使用该连接执行SQL命令：

1. 连接超时：数据库服务器配置了连接超时时间，长时间闲置的连接会被自动关闭
2. 网络问题：不稳定的网络导致连接意外中断
3. 服务器重启：数据库服务重启后所有连接都会失效
4. 显式关闭：代码中调用了connection.end()或connection.destroy()但后续仍尝试使用

解决方案：使用连接池

node-mysql2提供了连接池(Pool)功能，这是解决此类问题的最佳实践。连接池会自动管理连接的创建、回收和重连，开发者无需手动处理连接状态。

基本连接池配置

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

// 创建连接池
const pool = mysql.createPool({
  host: 'localhost',
  user: 'root',
  password: 'password',
  database: 'my_db',
  waitForConnections: true,
  connectionLimit: 10,
  queueLimit: 0
});

// 使用连接池查询
async function queryExample() {
  const [rows] = await pool.query('SELECT * FROM users');
  return rows;
}

连接池的优势

1. 自动连接管理：连接池会在需要时创建连接，在查询完成后将连接返回到池中而不是关闭
2. 连接复用：避免频繁创建和销毁连接的开销
3. 故障恢复：自动处理连接断开和重连
4. 资源控制：通过配置限制最大连接数，防止数据库过载

高级配置建议

对于生产环境，建议进行以下配置优化：

const pool = mysql.createPool({
  // ...基本配置
  connectTimeout: 10000, // 连接超时时间(毫秒)
  waitForConnections: true, // 当无可用连接时等待(true)或立即报错(false)
  connectionLimit: 20, // 最大连接数
  queueLimit: 50, // 等待队列最大长度
  enableKeepAlive: true, // 保持连接活跃
  keepAliveInitialDelay: 0 // 保持连接初始延迟
});

最佳实践

1. 避免手动管理连接：除非有特殊需求，否则应该始终使用pool.query()而不是手动获取/释放连接
2. 事务处理：对于事务操作，可以使用pool.getConnection()获取专用连接
3. 错误处理：妥善处理查询错误，确保连接能正确返回池中
4. 环境区分：开发环境和生产环境使用不同的连接池配置

常见误区

1. 连接泄漏：获取连接后忘记释放，导致连接池耗尽
2. 过度配置：设置过大的connectionLimit可能导致数据库过载
3. 混合使用：同时使用连接池和独立连接，增加管理复杂度
4. 忽略错误：未处理连接错误可能导致应用状态不一致

通过遵循这些指导原则，开发者可以有效地避免"Can't add new command when connection is closed"错误，构建健壮的数据库应用。连接池机制不仅解决了连接状态问题，还能显著提升应用性能和可靠性。