Mocha异步测试中，Promise内assert判定为false时触发测试超时的问题

超时的核心逻辑是两个容易被忽略的JS Promise规则叠加导致的：

• 第一个认知误区：new Promise()的executor回调（也就是传入构造函数的第一个参数），如果是async函数，它内部抛出的错误不会被外层Promise的错误捕获链路接住。
  标准的Promise实现逻辑是：在构造函数内部同步调用executor，用同步try/catch包裹调用过程，一旦捕获到同步抛出的错误就自动调用reject。但async函数被调用时会立刻返回一个游离的隐式Promise，根本不会同步向外抛错，executor内部的所有运行错误，都会变成这个隐式Promise的reject值——而这个隐式Promise没有任何后续的catch处理，成为游离的未捕获异常，外层构造出来的Promise完全感知不到这些错误。
• 当executor内部执行到assert(false)时，校验抛出的异常会直接中断async函数的后续执行，后面的res(null)永远不会被调用。外层被创建的Promise会一直停留在pending状态，后续挂在它上面的then()、catch()回调都不会触发，你写的done()自然永远不会被调用，最终触发Mocha默认2s超时阈值。

补充对应你观察到的现象：当assert校验为true时，流程没有被异常中断，能顺利执行到res(null)，外层Promise正常触发resolve，后续链路走完调用done()，测试自然不会超时。

按照推荐优先级排序：

• 最推荐：用Mocha原生的异步Promise测试能力，移除手动写的Promise包裹和done回调
  Mocha本身原生支持async函数形式的测试用例，会自动等待整个测试流程的Promise结算，不需要手动做Promise封装：

  describe('test', () => {
    // 直接把测试回调声明为async函数，Mocha会自动跟踪Promise状态
    it('testcase', async () => {
      console.log("before");
      // assert抛出的错误会被Mocha自动捕获，直接判定测试失败，不会出现超时
      assert(false);
      console.log("after");
      // 真实业务的网络请求逻辑直接await即可
      // await request('/api/xxx')
    });
  });
  

  这种写法从根本上避免了手动构造Promise带来的状态遗漏问题，错误抛出后会直接被Mocha捕获为测试失败用例，不会出现悬停超时。

• 如果必须保留手动Promise包裹的写法，修正executor的错误捕获逻辑
  不要直接把async函数作为new Promise的executor，要把异步逻辑的错误通过try/catch手动传递给外层Promise的reject：

  it('testcase', (done) => {
    // executor换回普通同步函数，不再是async
    new Promise((res, rej) => {
      // 内部通过立即执行async函数处理异步逻辑，手动捕获全链路错误
      (async () => {
        try {
          console.log("before");
          assert(false);
          console.log("after");
          res(null);
        } catch (err) {
          // 把捕获到的错误手动传递给外层Promise的reject
          rej(err);
        }
      })();
    }).then(() => done())
      // 注意这里要把捕获到的错误传给done，不能直接调用done()吞掉测试失败的信号
      .catch((err) => done(err));
  });
  

  这种写法需要注意两个细节：一是不能把reject出来的测试错误完全吞掉，必须把错误对象传给done(err)，Mocha才能正确判定测试失败；二是要覆盖所有可能的异常分支，不能遗漏错误捕获。

• 不推荐的写法：直接依赖async函数executor的游离错误捕获，这种写法很容易出现遗漏的错误分支，维护成本极高，仅作原理理解使用，不要在业务代码中使用。

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