TypeScript如何捕获Promise内部异步方法抛出的运行时错误

问题本质 #

如果运行时错误发生在Promise执行器函数内部异步调用的回调函数中，该错误不会被外层捕获

Promise 构造函数的执行器只会自动捕获同步抛出的错误并转为 reject 状态，而 setTimeout 这类异步 API 的回调是在执行器同步执行完成后才进入事件队列执行的，此时执行器的执行上下文已经销毁，抛出的错误既不会被 Promise 本身的 .catch() 捕获，也不会被外层包裹的 try/catch 捕获，会直接触发全局未捕获错误事件。你给出的第一个示例代码中setTimeout回调抛出的错误无法被捕获，就是这个原因。

const myPromise = new Promise( ( resolve, reject ) => {
  setTimeout( () => {
    // 模拟异步方法中发生的错误
    throw new Error('Something bad happened');
  }, 1000);
} );
console.log( 'Started');
try {
  myPromise
  .then( res => console.log( res) )
  .catch( err => console.log( 'Promise.catch: ' + (err as Error).message))
  .finally( () => console.log( 'All done') );  
} catch( error) {
  console.log( 'Error in promise catched: ' + (error as Error).message);
}
console.log( 'Ended');

最优解决方案 #

你提到的「在可能抛出运行时错误的异步方法内部添加 try/catch 块，捕获错误后手动调用 reject()」是标准的正确处理方案，注意最佳实践是reject传入Error实例而非字符串，可保留错误栈方便后续排查问题：

const myPromise2 = new Promise( ( resolve, reject ) => {
  setTimeout( () => {
    try {
      throw new Error('2 - 模拟发生严重错误');
    }
    catch( erx) {
      reject(new Error( '2 - Promise内部错误: ' + erx.message));
    }
  }, 100);
} );

经过上述处理后，外层就可以正常通过Promise的.catch()方法或者await搭配try/catch捕获到内部异步抛出的错误。

补充优化建议 #

• 如果使用 async/await 语法可以简化错误捕获逻辑，async 函数会自动将内部抛出的所有错误转为 rejected 状态，不需要手动嵌套 try/catch 包装回调
• 禁止直接 reject 字符串、数字等非 Error 类型的值，避免丢失错误调用栈信息，增加线上问题排查成本

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