无法捕获Node内置函数回调中抛出错误的问题排查与求解

try/catch是同步调用栈专属的错误捕获机制，仅能捕获当前同步执行流运行过程中抛出的错误，完全无法捕获异步回调执行阶段抛出的错误。
你的代码执行时的时序逻辑如下：

• 同步执行阶段：进入外层try块，调用fs.readFile。该方法是异步非阻塞API，发起文件读取的系统调用后会立刻返回，不会等待IO完成。此时外层try/catch块会随着同步代码执行完毕直接退出，不会驻留等待后续回调执行。
• 异步执行阶段：Node.js底层线程池完成文件读取后，会将你传入的回调函数推入事件循环宏任务队列。等所有同步代码执行完毕、调用栈清空后，事件循环才会取出这个回调执行。此时回调的调用方是Node.js内部的FS模块（错误栈里的FSReqCallback.readFileAfterClose就是直接调用方），和之前已经执行完的外层try/catch没有任何调用栈关联，回调内抛出的错误会沿着当前调用栈一路向上冒泡到事件循环顶层，最终触发uncaughtException事件，这就是你观察到的现象。

正确的错误处理方案 #

1. 错误优先回调场景 #

针对fs.readFile这类传统错误优先回调风格的API，必须在回调函数内部包裹try/catch处理错误：

const { readFile } = require('node:fs')

readFile('./jsconfig.json', 'utf8', (err, res) => {
  try {
    if (err) throw err
    if (res) console.log('successfully read file')
    throw new Error(`THROWN BY BUILT-IN FUNCTION'S CALLBACK`)
  } catch (error) {
    console.log(`error caught: ${error.message}`)
  }
})

2. Promise/async await 场景 #

可以直接使用Node.js提供的Promise版本FS API，配合async/await就可以用外层try/catch捕获同异步错误，本质是因为await会暂停当前异步函数的执行，将后续逻辑加入微任务队列，错误抛出时仍在当前异步函数的执行上下文范围内：

const { readFile } = require('node:fs/promises')

async function readConfig() {
  try {
    const res = await readFile('./jsconfig.json', 'utf8')
    console.log('successfully read file')
    throw new Error(`THROWN AFTER AWAIT`)
  } catch (error) {
    console.log(`error caught by async function scope: ${error.message}`)
  }
}

readConfig()

注意：即便是async/await写法，也无法捕获脱离当前执行上下文的回调错误，比如setTimeout回调里抛出的错误，依然需要在回调内部处理。

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