Mocha与Chai测试Node.js API接口出现超时问题该如何排查

你遇到的接口仅在Mocha单元测试场景超时、Postman/curl调用正常的问题，可按以下步骤逐一排查：

• 第一步：检查数据库连接初始化时机
  原因：你的数据库连接是异步建立的，测试启动时可能MongoDB连接还未完成初始化，接口内的数据库查询就已经执行，导致请求挂起超时。Postman/curl一般是在服务完全启动后调用，连接已就绪因此不会出现该问题。
  修复方案：在测试用例前添加before钩子，等待数据库连接完成后再执行测试，示例代码如下：

  const database = require('../database/connection');
  describe('test', () => {
      before((done) => {
          // 已经连接成功直接进入测试
          if (database.readyState === 1) return done();
          // 等待连接成功后再进入测试
          database.once('open', done);
      });
      // 原有it测试逻辑
      it('test', (done) => {
          chai.request(app)
              .get('/user')
              .end((err, res) => {
                  res.should.have.status(200);
                  done();
              })
      })
  });
  

• 第二步：调整Mocha测试超时阈值
  原因：Mocha默认单测试用例超时时间为2000ms，测试环境下数据库连接建立、查询耗时可能超过该阈值，而Postman/curl默认超时时间远长于2s因此不会触发超时。
  修复方案：可以给单个测试用例设置更长的超时时间，或者全局调整Mocha超时参数：
  单测试用例设置示例：

  it('test', (done) => {
      // 原有测试逻辑
  }).timeout(10000); // 调整为10s超时
  

  全局调整可在执行mocha命令时添加参数：mocha test/*.js --timeout 10000
• 第三步：补全测试错误捕获逻辑
  原因：你当前的测试代码未处理接口请求的错误，如果请求抛出异常，断言res.should.have.status(200)会直接报错，done()永远不会执行，导致测试超时。
  修复方案：在回调中优先处理错误参数：

  .end((err, res) => {
      if (err) return done(err); // 有错误直接抛出，结束测试
      res.should.have.status(200);
      done();
  })
  

• 第四步：检查测试环境配置与错误日志
  原因：测试环境的数据库配置可能和你用Postman/curl调用时的环境配置不一致，比如账号密码、数据库地址错误导致连接失败，你当前的连接错误日志在测试环境下没有输出，无法感知错误。
  修复方案：修改数据库连接的错误事件监听，输出完整错误信息：

  database.on('error', (err) => {
      console.error('数据库连接失败：', err);
      process.exit(1);
  });
  

  同时核对测试环境配置文件中的数据库连接参数是否正确。
• 第五步：补全异步路由的错误捕获
  原因：你当前的接口路由是async异步函数，没有添加错误捕获逻辑，如果数据库查询抛出异常，请求会直接挂住没有响应，导致测试超时。
  修复方案：给路由添加try/catch捕获异常：

  router.get('/', async (req, res, next) => {
      try {
          const collection = database.collection('user');
          const users = await collection.find().toArray();
          res.status(200).send(users);
      } catch (err) {
          next(err); // 把错误交给全局错误中间件处理
      }
  });
  

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