Jest测试中beforeAll提前执行问题及MongoDB前置连接咨询

我之前也碰到过类似的坑——明明写了beforeAll要先连MongoDB，结果测试用例直接就跑起来了，数据库还没准备好。结合你的场景，我整理了几个最可能的原因和对应的解决办法：

1. 异步回调没正确告知Jest完成 #

你的beforeAll用了done回调，但如果db.connect的回调里没正确调用done()（包括错误场景），Jest会因为超时或者认为钩子未完成，直接跳过钩子执行测试。

修正后的代码示例：

beforeAll((done) => {
  db.connect(url, (err) => {
    if (err) {
      console.error('MongoDB连接失败:', err);
      done(err); // 传递错误给Jest，让测试终止
      return;
    }
    console.log('MongoDB连接成功');
    done(); // 必须调用done告知Jest钩子执行完成
  });
});

如果你的db.connect支持Promise（或者可以封装成Promise），更推荐用async/await风格，不容易遗漏完成信号：

// 先把回调风格的连接改成Promise风格
const connectDB = () => {
  return new Promise((resolve, reject) => {
    db.connect(url, (err) => {
      if (err) reject(err);
      else resolve();
    });
  });
};

// 然后beforeAll用async函数
beforeAll(async () => {
  await connectDB();
});

2. 模块加载时的提前执行坑 #

如果你的app或者db模块在require导入阶段就自动执行了连接操作，那这部分代码会在Jest的钩子之前运行——因为模块加载是测试文件执行的最开始阶段，早于任何Jest钩子。

比如如果db.js里有这样的代码：

// db.js 错误示例：模块加载时直接执行连接
const url = 'mongodb://localhost:27017';
db.connect(url, (err) => { ... }); 
module.exports = db;

解决办法是把连接逻辑封装成函数，只在beforeAll里调用，不要放在模块顶级作用域自动执行。

3. 调整Jest的并发测试配置 #

Jest默认会并行运行多个测试文件，如果你的测试分散在多个文件里，可能会出现测试先于钩子执行的情况。可以在jest.config.js里强制串行执行：

module.exports = {
  runInBand: true, // 强制串行执行所有测试，确保beforeAll在所有测试前完成
};

不过runInBand会减慢测试速度，如果你只有单个测试文件出问题，优先检查前面的两点。

4. 确认beforeAll的作用域正确 #

如果你的beforeAll是放在某个describe块内部，那它只会在这个describe的测试用例之前执行，而不是所有测试。确保beforeAll在测试文件的顶级作用域，或者放在包含所有测试用例的外层describe里：

// 正确：顶级作用域的beforeAll，作用于所有测试
beforeAll(() => { ... });

describe('API测试集合', () => {
  test('GET /接口测试', async () => {
    const res = await request(app).get('/xxx');
    expect(res.statusCode).toBe(200);
  });
});

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