Mocha（Node.js）2000ms超时问题：旧回调写法为何失效？

Hey，我来帮你把这个问题掰明白——你遇到的其实是Mocha处理异步钩子时的一个经典坑，咱们一步步拆解：

旧写法的问题出在哪？ #

你的旧代码用了Mocha的done回调来标记异步操作完成，但这里藏着一个容易踩的陷阱：如果then回调内部抛出异常，可能会导致done()永远不被调用，或者Mocha无法正确捕获错误，最终触发超时。

咱们再看一遍旧代码的结构：

let response = null
before('read data', done => {
  request( { uri: 'some/endpoint' } )
    .then(resp => {
      response = fromJS(resp) // 这里如果抛出异常，下面的done()就不会执行
      done()
    })
    .catch(e => {
      done(e)
    })
})

乍一看，catch好像能捕获所有错误，但这里有个容易忽略的细节：then回调里的同步异常（比如fromJS处理返回数据时出错）会被Promise包装成reject，理论上应该会传递到后续的catch里，调用done(e)。但为什么会触发超时？

为什么最近服务器上会出问题？ #

结合你说的“本地正常、之前服务器正常，最近突然超时”，最可能的原因有两个：

1. 服务器返回的数据结构变了，导致fromJS抛出异常：
   比如服务器端的接口返回格式有细微调整，本地测试数据没更新，但服务器上的真实返回让fromJS(resp)执行时抛出异常。而在某些环境（比如旧版本Node.js或Mocha）下，这个异常没有被正确传递到catch回调，导致done()完全没被调用，Mocha一直等到超时。
2. 依赖版本升级带来的行为变化：
   如果你最近升级了服务器上的Mocha或Node.js，新版本对异步钩子的校验更严格了——比如旧版本Mocha会忽略Promise链的错误，只傻等done()；新版本则会对done回调的调用时机和Promise状态做更严格的校验，一旦Promise链出现未处理的reject，可能会直接忽略done()的调用，最终触发超时。

为什么新写法能正常工作？ #

你的新代码用了async/await，这是Mocha现在更推荐的异步钩子写法：

let response = null
before('read data', async () => {
  // 这里的Promise.resolve是多余的，直接await request(...)就行
  response = fromJS( await request( { uri: 'some/endpoint' } ) )
})

这里的核心优势是：

• 当钩子是async函数时，Mocha会自动监听函数返回的Promise状态，不需要手动调用done。
• 不管是request的Promise reject，还是fromJS抛出异常，都会直接被Mocha捕获并标记为测试失败，而不是一直等待超时——因为Mocha会全程跟踪Promise的状态变化，不会因为某个回调没执行就卡住。

总结一下 #

用done回调结合Promise时，很容易因为回调内部的异常、Promise链的错误传递问题导致done()没被正确调用，最终触发超时。而async/await的写法更简洁，也避免了这类回调嵌套带来的隐藏问题，是现在处理Mocha异步逻辑的最优解。

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