Mocha beforeEach超时问题求助：Express+MongoDB接口测试遇阻

兄弟，我之前搭Express+MongoDB的测试环境时，也踩过beforeEach超时的坑，太懂这种卡半天找不到原因的难受了。咱们从几个常见的点入手排查，应该能很快解决：

1. 确保Mongoose连接正确处理异步逻辑 #

Mongoose的connect方法是异步的，如果beforeEach里没等它完成就继续执行，Mocha就会触发超时。一定要用async/await或者done回调来等待连接完成：

// 用async/await的写法（推荐）
beforeEach(async () => {
  // 先确保测试环境的数据库URI正确
  await mongoose.connect(process.env.TEST_MONGODB_URI);
  // 清空测试集合（如果需要）
  await User.deleteMany({});
});

// 或者用done回调的写法
beforeEach((done) => {
  mongoose.connect(process.env.TEST_MONGODB_URI, (err) => {
    if (err) {
      console.error("数据库连接失败:", err);
      return done(err);
    }
    User.deleteMany({}, done); // 清空集合后调用done
  });
});

这里要注意：测试环境的MongoDB URI必须单独配置，别和开发环境的数据库混了，比如用mongodb://localhost:27017/api_test_db这种专门的测试库。

2. 检查数据库初始化操作是否阻塞 #

很多人会在beforeEach里清空测试数据（比如User.deleteMany({})），如果这个操作没加await或者没在回调里调用done，就会导致异步操作卡住，最终触发超时。务必确保所有数据库操作都等待完成。

3. 调整Mocha的超时时间 #

Mocha默认的超时时间是2000ms，如果是第一次连接MongoDB，或者初始化数据较多，这个时间可能不够。可以两种方式调整：

方式一：在beforeEach里设置（注意不能用箭头函数） #

beforeEach(function() {
  this.timeout(5000); // 把超时时间改成5秒
  return mongoose.connect(process.env.TEST_MONGODB_URI)
    .then(() => User.deleteMany({}));
});

方式二：在测试脚本里全局设置 #

在package.json的test命令里加上--timeout参数：

{
  "scripts": {
    "test": "mocha --timeout 5000"
  }
}

4. 捕获未处理的Promise拒绝 #

如果beforeEach里的异步操作出错了（比如MongoDB服务没启动、URI写错），但没有被捕获，Mocha可能不会直接抛出错误，而是卡住直到超时。可以在测试文件开头加一段代码，把未处理的拒绝抛出来：

process.on('unhandledRejection', (err) => {
  console.error("未处理的Promise错误:", err);
  throw err;
});

这样就能看到具体的错误原因，比如“MongoDB服务未启动”或者“URI无效”，直接定位问题。

5. 确保测试环境与开发环境完全隔离 #

你已经设置了process.env.NODE_ENV = 'test'，但要确保你的数据库配置代码是根据环境变量切换的。比如在你的数据库连接文件里：

const mongoose = require('mongoose');

const getDbUri = () => {
  if (process.env.NODE_ENV === 'test') {
    return process.env.TEST_MONGODB_URI || 'mongodb://localhost:27017/api_test_db';
  }
  return process.env.MONGODB_URI || 'mongodb://localhost:27017/api_dev_db';
};

mongoose.connect(getDbUri());

避免不小心连到开发数据库，导致操作缓慢或者数据冲突。

按照上面的步骤排查，基本就能解决beforeEach超时的问题。我当时就是因为没await清空集合的操作，卡了半天，后来加了await就正常了😂

内容的提问来源于stack exchange，提问作者Julián Bonilla