Node.js Mocha无法连接MySQL数据库问题求助

看起来你在Mocha/Chai单元测试中遇到了MySQL连接问题，我来帮你梳理几个常见的排查方向和解决办法：

1. 确认测试环境的数据库配置正确性 #

你已经设置了process.env.NODE_ENV = 'test'，首先要确保测试环境对应的数据库配置参数是正确的：

• 检查你的配置文件是否根据NODE_ENV加载了不同的配置（比如单独的config/test.js或区分环境的配置对象）
• 重点核对host、port、username、password、database这几个核心参数，不要和开发环境的配置混淆

示例配置加载代码：

// config/index.js
const env = process.env.NODE_ENV || 'development';
const config = require(`./${env}`);
module.exports = config;

2. 检查MySQL服务状态与网络连通性 #

• 如果是本地MySQL，先确认服务是否启动：
  • Windows：打开「服务」管理器，找到MySQL服务查看运行状态
  • Mac/Linux：执行命令sudo systemctl status mysql（Linux）或brew services list（Mac）检查状态
• 如果是远程数据库，测试端口连通性：
  执行nc -zv your-mysql-host 3306（Mac/Linux）或telnet your-mysql-host 3306（Windows），确认3306端口是否能正常访问

3. 验证数据库用户的连接权限 #

测试用的数据库用户可能没有从当前主机连接的权限：

1. 登录MySQL服务器，执行以下命令查看用户权限：

   SELECT user, host FROM mysql.user;
   

2. 如果测试在本地运行，确保存在类似test_user@localhost的用户；如果是远程测试，需要test_user@%（允许任意主机连接）
3. 若权限不足，执行授权命令：

   GRANT ALL PRIVILEGES ON your_test_db.* TO 'test_user'@'localhost';
   FLUSH PRIVILEGES;
   

4. 确保数据库连接完成后再执行测试 #

你的before钩子目前是空的，很可能数据库还没完成初始化就开始跑测试了。要在before中等待数据库连接成功后再调用done()：

示例代码：

before((done) => {
  // 引入你的数据库模块
  const db = require('../db');
  db.connect()
    .then(() => {
      // 执行数据库清理操作
      return db.query("TRUNCATE TABLE users");
    })
    .then(() => {
      done(); // 连接+清理完成，启动测试
    })
    .catch(err => {
      console.error('数据库连接/初始化失败:', err);
      done(err); // 将错误传递给Mocha，终止测试并显示详情
    });
});

5. 捕获并查看具体的连接错误信息 #

模糊的“无法连接”问题，查看详细错误日志往往能直接定位原因：

• 在你的数据库连接代码中添加错误捕获，打印完整错误：

// 以mysql2异步连接为例
const mysql = require('mysql2/promise');
async function connectDB() {
  try {
    const connection = await mysql.createConnection({
      host: config.db.host,
      user: config.db.user,
      password: config.db.password,
      database: config.db.name
    });
    console.log('测试环境数据库连接成功');
    return connection;
  } catch (err) {
    console.error('测试环境数据库连接错误详情:', err);
    throw err; // 抛出错误让测试捕获
  }
}

通过以上步骤排查，应该能定位到无法连接的具体原因并解决问题。

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