使用Jest进行API测试遇超时问题：Async callback未在指定时限内调用

你遇到的这个超时错误是Jest异步测试里的常见问题——Jest没检测到你的异步回调被触发，所以在默认5秒等待后抛出了超时提示。结合你的代码和错误信息，我给你几个针对性的解决方案：

1. 改用Frisby的Promise语法（最推荐） #

Frisby本身返回Promise，Jest天然支持Promise类型的测试，完全不需要依赖done回调，能避免很多回调嵌套带来的隐性问题。把你的测试改成下面两种形式之一：

用async/await（最直观易读） #

it('GET should return a status of 200 OK', async () => {
  await frisby
    .get('url-api') // 记得替换成你的真实API地址
    .expect('status', 200);
});

直接返回Promise #

it('GET should return a status of 200 OK', () => {
  return frisby
    .get('url-api')
    .expect('status', 200);
});

Jest会自动等待这个Promise完成，只要API响应正常，就不会再出现超时问题。

2. 修复done回调的用法（如果你坚持用回调） #

你原来的代码直接把Jest的done传给Frisby的.done()，但如果Frisby内部请求失败（比如API返回错误状态码），可能不会正确触发done，导致Jest一直等待超时。你需要手动处理错误分支：

it('GET should return a status of 200 OK', function(done) {
  frisby
    .get('url-api')
    .expect('status', 200)
    .done(err => {
      // 如果有错误，把错误传给done，Jest会标记测试失败
      if (err) return done(err);
      // 没有错误就调用done，告诉Jest测试完成
      done();
    });
});

3. 延长Jest的超时时间（治标方案） #

如果你的测试环境API确实响应很慢（超过5秒），可以单独给这个测试用例设置更长的超时：

it('GET should return a status of 200 OK', function(done) {
  // 把超时设为10秒，根据实际情况调整
  this.timeout(10000);
  frisby
    .get('url-api')
    .expect('status', 200)
    .done(done);
});

或者在jest.config.js里全局设置超时：

module.exports = {
  testTimeout: 10000, // 全局超时设为10秒
};

不过这个只是临时解决方法，优先建议调整测试写法。

4. 先确认API本身的可用性 #

有时候超时根本不是测试代码的问题——比如你写的API地址有误，或者测试环境的API服务不可达，导致请求一直挂着。先单独用curl、Postman或者浏览器访问这个API，确认它能在5秒内正常返回响应。

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