使用SuperTest测试返回HTTP 400的接口时出现超时问题

这种超时问题我碰到过好几次，先给你划重点：不是测试代码需要加try/catch的问题，大概率是你的后端服务在处理无效年份请求时，根本没正确返回400响应，而是让请求一直挂着了。

先排查核心原因：后端接口是否真的能返回400？ #

别先盯着测试代码看，先手动验证下接口——用curl或者Postman直接调用GET /api/v1/songs/year/1776，看看是不是会卡住很久，或者干脆没响应。如果手动调用也超时，那问题100%出在后端逻辑里，常见的坑有这几个：

• 处理无效年份时，只设置了res.status(400)，但忘了调用res.send()/res.json()结束响应；
• 错误分支里有异步操作没正确处理（比如某个Promise一直没resolve/reject）；
• 全局错误处理中间件没捕获到这个错误，导致请求挂起。

举个典型的后端错误例子（假设用Express）：

app.get('/api/v1/songs/year/:year', async (req, res) => {
  const year = parseInt(req.params.year);
  if (year < 1900) {
    res.status(400); // 这里只设了状态码，但没发送响应！请求会一直挂着
  }
  // 后续正常逻辑...
});

这种情况下，请求永远不会结束，测试用例自然会超时。

测试代码的优化建议（可选，但更严谨） #

虽然根源在后端，但可以给测试代码加一点处理，让报错信息更清晰：

it('When parameter is an unknown year, then response Status-Code should be 400 (Bad Request)', async () => {
  const response = await request.get('/api/v1/songs/year/1776');
  // 用Chai的should断言链更直观
  response.should.have.status(400);
});

注意：SuperTest对4xx/5xx响应不会抛出异常，只有网络错误或服务器崩溃才会触发catch，所以不需要额外加try/catch（加了也没用在这个场景里）。

临时应急方案（不推荐长期用） #

如果确实需要临时延长超时时间排查，可以给单个用例设置超时：

it('When parameter is an unknown year, then response Status-Code should be 400 (Bad Request)', async () => {
  const response = await request.get('/api/v1/songs/year/1776');
  response.statusCode.should.equal(400);
}).timeout(5000); // 把超时时间改成5秒

但这只是权宜之计，一定要解决后端没正确返回响应的问题。

总结 #

先去检查后端的错误处理逻辑，确保在遇到无效年份时，不仅设置400状态码，还要调用res.send()/res.json()结束请求。只要后端能正常返回400，你的测试用例肯定能通过，不会超时。

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