NodeJS中如何验证MySQL连接池在Bot启动时是否在线？

核心问题原因 #

createPool初始化连接池时不会立即建立数据库连接，仅创建配置结构，实际连接是在首次执行查询时才会建立，所以Bot启动时数据库离线不会触发错误。要在启动时验证连接状态，必须主动从池中获取连接进行验证。

正确的检测实现方式 #

使用统一的连接池配置（确保和Bot其他模块复用同一配置），启动时主动获取连接验证可用性：

const mysql = require('mysql');

// 统一连接池配置，所有模块复用此配置避免不一致问题
const poolConfig = {
  host: 'localhost',
  user: '你的数据库用户名',
  password: '', // 即使无密码也要显式设为空字符串，避免MySQL权限校验异常
  database: '你的数据库名',
  connectionLimit: 10
};

// 创建连接池
const pool = mysql.createPool(poolConfig);

// 验证连接池可用性的函数
function validateDbConnection() {
  return new Promise((resolve, reject) => {
    pool.getConnection((err, connection) => {
      // 优先处理连接错误
      if (err) {
        return reject(err);
      }
      // 连接成功后释放连接回池
      connection.release();
      resolve();
    });
  });
}

// Bot启动入口
async function initBot() {
  try {
    await validateDbConnection();
    console.log('数据库连接池验证通过，Bot启动中...');
    // 执行Bot其他初始化逻辑
  } catch (err) {
    console.error('数据库连接失败，Bot终止启动:', err.message);
    // 直接退出进程，避免Bot处于不可用状态
    process.exit(1);
  }
}

// 启动Bot
initBot();

你遇到的错误分析 #

1. ER_ACCESS_DENIED_ERROR权限错误 #

• 核心原因是检测代码的连接配置和其他模块不一致：比如其他模块显式设置了password: ''，但检测代码漏传该字段，MySQL会将未传递password的请求判定为"使用密码但未提供"，触发权限拒绝。
• 确认数据库用户权限：执行SELECT user, host FROM mysql.user;，确保你的用户允许从当前主机（localhost或%）访问，且authentication_string为空（无密码限制）。

2. TypeError: Cannot read properties of undefined (reading 'state') #

• 该错误是因为你之前的代码未先判断err就直接访问connection.state。当连接失败时，connection参数为undefined，自然无法读取state属性。必须先处理err分支，再操作connection。

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