使用Jest测试Node.js Express MongoDB接口时遇超时错误

我完全懂你的 frustration——明明手动启动服务器时GET接口跑起来毫无问题，可Jest测试就是卡着超时，搜遍常规解决方案也没辙。结合你给出的代码片段，咱们一步步深挖可能的问题：

1. 先确认测试里的App实例是否正确就绪 #

有时候我们在测试中导入的app可能没完成启动逻辑，或者启动时机不对。比如如果你的app.js里直接写了app.listen()，测试时导入的app可能还没完成服务器启动，导致supertest连不上。

解决思路：
把App定义和服务器启动逻辑拆分：

• app.js只负责配置路由、中间件，不调用listen()
• 单独写server.js来启动服务器：app.listen(3000)
• 测试里直接导入app，而非启动后的服务器实例

或者在测试用例里手动控制服务器启停：

const request = require('supertest');
const app = require('../../app');
let testServer;

beforeAll((done) => {
  // 用测试专用端口，避免和本地服务冲突
  testServer = app.listen(3001, done);
});

afterAll((done) => {
  testServer.close(done);
});

2. 检查测试用例的异步写法是否规范 #

这是最容易踩坑的点：如果测试函数是异步的，但既没返回Promise，也没调用done回调，Jest会误以为测试已经同步完成，直接触发超时。

❌ 错误示例：

test('GET /api/test', () => {
  request(app).get('/api/test').expect(200);
});

✅ 正确写法二选一：

// 用async/await（推荐）
test('GET /api/test', async () => {
  const res = await request(app).get('/api/test');
  expect(res.statusCode).toBe(200);
});

// 用done回调
test('GET /api/test', (done) => {
  request(app)
    .get('/api/test')
    .expect(200)
    .end((err) => {
      if (err) return done(err);
      done();
    });
});

3. 排查路由/中间件里的异步阻塞 #

虽然服务器运行时正常，但测试环境下可能某些异步操作卡住了——比如数据库连接在测试环境未正确配置、第三方API在测试时无法访问，或者路由里有未处理的Promise。

快速验证方法：
临时把GET接口改成返回静态数据，看看测试是否还超时：

// 临时修改路由测试
app.get('/api/test', (req, res) => {
  res.json({ status: 'success' });
});

如果这样测试能通过，那问题肯定出在原路由逻辑里的异步操作，比如数据库连接超时、某个异步函数没有正确resolve。

4. 调整Jest超时（最后手段） #

你说试过常见方案，可能已经调过，但还是提一下：可以给单个测试或全局设置更长的超时时间。

• 单个测试设置：

test('GET /api/test', async () => {
  const res = await request(app).get('/api/test');
  expect(res.statusCode).toBe(200);
}, 10000); // 10秒超时

• 全局设置（jest.config.js）：

module.exports = {
  testTimeout: 10000,
};

5. 检查supertest版本兼容性 #

有时候supertest和Jest、Express的版本不兼容也会导致奇怪的超时问题。可以试试升级/降级supertest版本，比如确认supertest v6+和你的Express 4.x版本是否匹配。

先从异步写法和App启动状态这两个基础点排查，再逐步深入路由逻辑，应该能找到问题根源。

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