正确处理异步错误需在 async 函数中用 try-catch 捕获 await 异常(1)所有 await 应置于 try-catch 内并按需重试或抛出(2)顶层调用须通过 asyncHandler 等包装器确保错误传递(3)监听 unhandledRejection 作为最后防线(4)避免遗漏 return 导致 Promise 脱离上下文。

在使用异步函数时,未捕获的 Promise 拒绝是常见但危险的问题。它可能导致程序崩溃、资源泄漏或难以追踪的错误。正确的错误处理不仅能提升稳定性,还能增强代码可读性。以下是避免未捕获 Promise 拒绝的最佳实践。
始终使用 try-catch 包裹 await 表达式
async 函数内部的 await 调用可能抛出异常,这些异常本质上是被拒绝的 Promise。必须使用 try-catch 显式捕获它们。
说明: 即使你调用了异步函数,不加 await 的调用不会触发同步错误。正确做法:
- 在 async 函数中,所有 await 操作都应置于 try-catch 块内
- 捕获后根据业务决定是重试、记录日志还是向上抛出
示例:
async function fetchData() {
try {
const res = await fetch('/api/data');
if (!res.ok) throw new Error('Network failed');
return await res.json();
} catch (err) {
console.error('Fetch error:', err);
throw err; // 根据需要重新抛出
}
}
确保顶层异步调用有错误处理机制
顶级 await 或事件回调中的异步操作容易遗漏错误处理,尤其是 Node.js 环境下。
- 在 Express 路由中,不要让 async 中间件直接抛出错误
- 使用统一的错误中间件捕获未处理的 reject
推荐包装器:
function asyncHandler(fn) {
return (req, res, next) =>
Promise.resolve(fn(req, res, next)).catch(next);
}
app.get('/data', asyncHandler(async (req, res) => {
const data = await fetchData();
res.json(data);
}));
监听 unhandledrejection 事件作为最后防线
尽管不应依赖此机制,但在生产环境中监听全局未捕获的 Promise 拒绝有助于监控和调试。
- Node.js 中可通过 process.on('unhandledRejection') 捕获
- 浏览器中可用 window.addEventListener('unhandledrejection')
示例(Node.js):
process.on('unhandledRejection', (reason, promise) => {
console.error('Unhandled Rejection at:', promise, 'reason:', reason);
// 记录日志或通知监控系统
});
注意: 这只是补救措施,不能替代代码内的正确错误处理。
避免忘记返回 Promise 导致的陷阱
在高阶逻辑中,如果忘记 return 一个 await 或 Promise,会导致外部无法感知内部异步错误。
- 确保 async 函数真正返回等待的结果
- 链式调用中尤其要注意是否遗漏 return
错误示例:
async function badHandler() {
await someAsyncTask(); // 错误不会被外层捕获
}
// 外部调用时无法 catch
badHandler().catch(err => console.log(err)); // 可能无效
基本上就这些。只要坚持在 await 周围使用 try-catch,配合全局监听和统一封装,就能有效杜绝未捕获的 Promise 拒绝问题。不复杂但容易忽略。










