问题现象与常见误解

在 Node.js 开发中，用 try/catch 包裹 async 函数调用是处理异步错误的常规做法。但有时开发者会发现，明明 async 函数内部抛出错误或返回了 rejected Promise，外层的 try/catch 却没有捕获到，导致进程退出或出现未捕获异常。这种情况通常不是因为 async 函数本身的问题，而是调用方式上忽略了 Promise 的异步特性。

陷阱：async 函数未 await 时 try/catch 失效

在 Node.js 中，直接使用 try/catch 包裹 async 函数调用时，若 async 函数内部返回了 rejected 状态的 Promise，但该 Promise 没有被 await，则 try/catch 无法捕获到 reject 错误。例如：try { asyncFunc(); } catch(e) { ... } 中的 asyncFunc() 返回的 Promise 被忽略，错误将变成未捕获的 Promise 异常。正确的做法是用 await 等待 Promise，或使用 .catch() 方法处理。

这个陷阱在初期容易被忽略，因为代码看起来像是同步的。适用场景是：当调用一个 async 函数但不需要立即等待其完成时，比如触发一个后台任务。此时如果只靠 try/catch 包裹，异步错误会逃逸。验证方式：可以在 asyncFunc 内部加一个 console.log 确认其执行，但 catch 不触发。风险边界：未await的 rejected Promise 如果未被任何 .catch() 处理，会触发 unhandledRejection 事件，在 Node.js 15.0.0 以上版本中，默认行为是直接终止进程，后果严重。

如何判断 try/catch 是否有效

判断 try/catch 是否有效捕获 Promise 的 reject，核心检查点有两个：一是 async 函数内部使用 throw 或 return rejected Promise，二是外部调用时是否使用了 await。若未使用 await，则 try/catch 仅捕获同步错误，而对异步 reject 无效。可以在调用处打印 Promise 的状态，或者通过 process.on('unhandledRejection') 事件观察是否有遗漏的未捕获错误。

操作动作：在可疑的调用点之后立即检查 Promise 的状态，比如 const p = asyncFunc(); console.log(p); 看其是 pending 还是 rejected。更直接的是用 p.catch(e => console.log('caught', e)) 测试。如果 catch 执行了但 try/catch 没反应，说明问题就在“未 await”。验证方式：在 try/catch 内只放 await 表达式，其他同步代码不受影响。另外，如果 async 函数内部有多个异步操作但只 await 了第一个，后续的 reject 也会漏掉。

推荐操作：始终 await 或使用 .catch()

对于 async 函数调用的错误捕获，推荐始终使用 await 并包裹在 try/catch 中。如果不需要等待结果，也应使用 .catch() 处理错误，以避免未捕获的 Promise 异常。例如：asyncFunc().catch(err => console.error(err))。另一种方案是在 async 函数内部使用 try/catch 自行处理错误，然后返回正常值或再次抛出。

操作取舍：如果函数调用后不需要后续逻辑，用 .catch() 更简洁，但需要注意 .catch() 本身返回一个 resolved Promise，不会影响主流程。如果需要根据错误决定后续操作，则用 await + try/catch 更灵活。适用场景：所有涉及到 async 函数调用的地方，尤其是有潜在 reject 风险的代码。风险边界：在同一个 async 函数内，如果并发启动多个异步操作（如 Promise.all 或 forEach 循环），每个操作都应该有独立的错误处理，否则一个 reject 可能导致整个 Promise.all 失败。建议对每个异步操作显式处理错误，或使用 Promise.allSettled 来忽略个别失败。

检查方法：全局监听与调试

如果你怀疑 try/catch 未捕获到 reject，可以在全局监听 unhandledRejection 事件：process.on('unhandledRejection', (reason, promise) => { console.error('Unhandled Rejection at:', promise, 'reason:', reason); }); 这会打印出所有未被捕获的 Promise 拒绝。还可以用调试器在 catch 处打断点，观察是否执行到。另外，在 Promise 创建后立即调用 .catch() 也能提前排查。

这个检查方法在开发阶段很有用，可以快速定位漏网之鱼。但注意，不要在生产环境长期使用全局监听，因为未捕获的错误应该被显式处理。可以通过环境变量区分：只在 NODE_ENV=development 时启用。另一种边角情况：如果 async 函数内部使用回调式异步（比如旧式 fs.readFile），而不是 Promise，那么 try/catch 也无效，此时需要 wrap 成 Promise 或用 util.promisify。整体上，先确认调用处是否 await，再检查链路上的每个 Promise 是否都有处理，最后用全局监听兜底定位，就能解决大部分 try/catch 捕获不到的疑问。