使用Mocha、Chai、Supertest测试后端API超时返回408错误的实现方法

以下是两种适配不同测试目标的实现方式： #

方案1：验证服务端超时配置生效（触发服务端返回408状态码） #

该方案用于确认你的后端服务在请求处理超时时，会正确返回408状态码，实现步骤如下：

• 首先在测试环境的对应接口逻辑中加入可触发的延迟逻辑，无需侵入生产环境代码：

// 后端路由示例（仅测试环境生效）
app.get('/your-target-api', async (req, res) => {
  if (process.env.NODE_ENV === 'test' && req.headers['x-test-force-timeout']) {
    // 等待时长超过服务端配置的超时阈值，比如服务端设了3s超时就等待4s
    await new Promise(resolve => setTimeout(resolve, 4000))
  }
  // 原有业务逻辑
})

• 调整测试用例，同时将supertest自身的超时时间设得比服务端超时阈值更长，避免测试框架先抛出超时错误打断预期逻辑：

describe("timeout call", () => {
    it("should return error 408", async () => {
        await supertest(app)
            .get(url)
            .set('X-Test-Force-Timeout', '1')
            // 调整supertest超时时间为5s，长于服务端3s的超时阈值
            .timeout(5000)
            .expect(408)
    });
});

不想修改业务代码的话，可以用Sinon等测试工具Stub对应接口的处理函数，强制返回延迟Promise即可，无需改动原有逻辑。

方案2：验证客户端侧超时处理逻辑 #

如果你的测试目标是验证客户端遇到超时场景时的处理逻辑，不需要服务端真实返回408，可以直接设置极短的请求超时时间强制触发客户端超时：

describe("client side timeout", () => {
    it("should handle timeout error correctly", async () => {
        try {
            await supertest(app)
                .get(url)
                // 设置10ms的极短超时时间，强制触发超时
                .timeout(10)
        } catch (err) {
            // 验证捕获到的是超时错误
            expect(err.code).to.equal('ECONNABORTED')
            expect(err.timeout).to.equal(10)
        }
    });
});

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