Promise未处理拒绝不会自动抛出全局错误，需监听unhandledrejection事件兜底；根本解法是每个Promise链末尾加.catch()或用async/await配try/catch显式处理。

Promise 的未处理拒绝（unhandled rejection）错误不会自动抛出到全局，容易被忽略，导致静默失败。要捕获这类错误，需监听全局的 unhandledrejection 事件。

监听 unhandledrejection 事件

浏览器和 Node.js 都支持 unhandledrejection 全局事件，它在 Promise 被拒绝且没有绑定 .catch() 或 await 处理时触发。

• 浏览器中可在 window 上监听：

window.addEventListener('unhandledrejection', event => {
  console.error('未处理的 Promise 拒绝:', event.reason);
  event.preventDefault(); // 阻止默认控制台警告（可选）
});

• Node.js 中监听 process：

process.on('unhandledRejection', (reason, promise) => {
  console.error('未处理的 Promise 拒绝:', reason);
});

确保每个 Promise 都有错误处理

事件监听只是兜底，根本解法是主动处理拒绝。常见遗漏场景包括：

• .then(successHandler) 缺少第二个参数（错误处理器）
• async/await 中未用 try...catch 包裹
• 多个 Promise 并行时（如 Promise.all），其中一个失败但没被捕获

推荐写法：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

立即学习“Java免费学习笔记（深入）”；

// ✅ 正确：显式 catch
promise.then(data => console.log(data)).catch(err => console.error(err));

// ✅ async/await + try catch
try {
  const data = await someAsyncCall();
} catch (err) {
  console.error(err);
}

开发阶段辅助检测

现代浏览器开发者工具会在控制台标记未处理拒绝（带黄色警告图标），配合 unhandledrejection 监听可快速定位问题。

• Chrome / Edge：打开 DevTools → Console，留意 “Uncaught (in promise)” 提示
• VS Code 调试时，可在“断点”面板中启用 “Uncaught Exceptions” → 勾选 “Promise Rejection”

注意 Node.js 的行为差异

Node.js 默认会在未处理拒绝后 1 秒退出进程（v15+），除非显式监听 unhandledRejection 并调用 event.preventDefault() 或处理掉它。

• 不监听会导致进程意外终止
• 监听后仍建议记录日志并做适当降级，而非简单阻止