async/await优雅的错误处理方法总结

async/await作为ES2017引入的异步编程语法糖，通过让异步代码呈现同步结构，显著提升了代码可读性，其错误处理机制相较于同步代码存在独特性——若await的Promise被reject且未捕获，会触发未处理的Promise rejection，可能导致应用异常中断，掌握async/await的错误处理方法，是构建健壮异步逻辑的关键，本文将系统总结优雅处理async/await错误的实践方案,助力开发者规避常见陷阱。

基础防线：try-catch捕获异步错误

async/await的核心错误处理依赖try-catch结构：async函数中，await的Promise若进入rejected状态，必须通过try-catch捕获，否则错误会向上冒泡至全局事件循环。

async function fetchData() {  
  try {  
    const response = await fetch('/api/data');  
    if (!response.ok) throw new Error('请求失败');  
    return await response.json();  
  } catch (error) {  
    console.error('数据获取异常:', error);  
    throw error; // 向上传递，由调用方处理  
  }  
}  

关键点：try-catch捕获的是Promise的reject值，而非异步操作本身的同步错误（如变量未定义这类同步错误仍会直接抛出），catch中建议抛出错误而非静默处理,避免上层调用方误以为操作成功。

全局兜底：unhandledrejection事件监听

即使代码中已大量使用try-catch，仍可能因疏忽遗漏某些边界场景（如动态创建的Promise），全局事件监听可作为最后一道防线：

• 浏览器环境：通过window.addEventListener('unhandledrejection')捕获未处理的Promise rejection：

  window.addEventListener('unhandledrejection', (event) => {  
    console.error('未捕获的Promise错误:', event.reason);  
    event.preventDefault(); // 阻止控制台报错  
  });  

• Node.js环境：使用process.on('unhandledrejection')：

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

  注意：全局监听仅用于兜底，不应替代局部try-catch,否则会掩盖代码逻辑缺陷。

错误分类：精准区分同步与异步错误

async/await场景中，错误来源可分为同步错误（函数体内非await代码）和异步错误（await的Promise rejection），需针对性处理：

async function mixedExample() {  
  try {  
    console.log(undefinedVar); // 同步错误：直接抛出，不会被catch捕获  
    const data = await fetch('/api'); // 异步错误：需catch捕获  
  } catch (error) {  
    if (error instanceof ReferenceError) {  
      console.error('同步变量错误:', error);  
    } else {  
      console.error('异步请求错误:', error);  
    }  
  }  
}  

实践中，建议将同步错误（如参数校验、依赖检查）放在await之前，避免混淆错误来源；异步错误则通过try-catch统一捕获，再根据错误类型（如网络错误、业务错误）分支处理。

上下文增强：为错误携带元信息

原始错误对象往往缺乏调用上下文（如请求参数、操作时间），增加调试难度，可通过扩展错误对象或添加自定义属性增强信息：

async function enhancedFetch(url, options) {  
  try {  
    const response = await fetch(url, options);  
    if (!response.ok) {  
      const error = new Error(`请求失败: ${response.status}`);  
      error.url = url;  
      error.options = options;  
      error.timestamp = new Date().toISOString();  
      throw error;  
    }  
    return response.json();  
  } catch (error) {  
    error.context = { url, options, timestamp };  
    throw error;  
  }  
}  

增强后的错误对象包含完整调用链信息，便于快速定位问题根源,尤其适合复杂业务场景。

容错重试：实现自动恢复机制

网络请求、文件读写等操作可能因临时故障失败，引入重试机制可提升系统健壮性，可通过递归或循环实现：

async function fetchWithRetry(url, retries = 3, delay = 1000) {  
  try {  
    const response = await fetch(url);  
    return response.json();  
  } catch (error) {  
    if (retries <= 0) throw error;  
    console.log(`重试中，剩余次数: ${retries - 1}`);  
    await new Promise(resolve => setTimeout(resolve, delay));  
    return fetchWithRetry(url, retries - 1, delay * 2); // 指数退避  
  }  
}  

关键优化：重试时采用指数退避策略（如delay递增），避免短时间内高频重试加重服务器负担；同时设置最大重试次数,防止无限循环。

批量处理：Promise.allSettled应对部分失败

当需要同时发起多个异步操作时，Promise.all会因任意一个失败而整体中断，而Promise.allSettled可确保所有操作完成，无论成功失败：

async function batchFetch(urls) {  
  const results = await Promise.allSettled(  
    urls.map(url => fetch(url).then(res => res.json()))  
  );  
  const successes = results  
    .filter(r => r.status === 'fulfilled')  
    .map(r => r.value);  
  const failures = results  
    .filter(r => r.status === 'rejected')  
    .map(r => r.reason);  
  console.log('成功:', successes);  
  console.log('失败:', failures);  
  return { successes, failures };  
}  

适用场景：数据聚合（如同时获取用户信息、订单记录）、批量校验（如表单多字段验证）等需容忍部分失败的场景。

工具辅助：第三方库简化错误处理

重复的错误处理逻辑可通过第三方库封装，减少代码冗余：

• p-retry：自动重试机制，支持自定义重试条件：

  import pRetry from 'p-retry';  
  const fetchWithRetry = () => pRetry(() => fetch('/api'), {  
    retries: 3,  
    onFailedAttempt: error => console.log(`尝试失败: ${error}`)  
  });  

• errable：错误分类与统一处理，支持错误类型注册：

  import { errable } from 'errable';  
  const fetchWithErrorHandling = errable(async () => {  
    const res = await fetch('/api');  
    if (res.status === 404) throw new NotFoundError();  
    return res.json();  
  });  

1. 避免空catch：catch中至少记录错误或向上抛出，避免静默掩盖问题；
2. 分层处理：底层函数负责捕获并包装错误，上层函数负责业务级错误决策；
3. 日志上报：结合监控系统（如Sentry、ELK）自动上报错误，实时追踪异常；
4. 错误恢复：对可恢复错误（如网络波动）提供降级方案（如返回缓存数据）。

FAQs

async/await中不使用try-catch会发生什么？
若await的Promise被reject且未用try-catch捕获，错误会触发全局的unhandledrejection事件，在浏览器中，可能导致页面控制台报错甚至异常终止；在Node.js中，默认会以非零状态码退出进程，除极少数场景（如全局已监听unhandledrejection），所有await操作都应配合try-catch使用。

如何在多个异步操作中只对特定错误处理？
可通过两种方式实现：一是利用Promise.allSettled获取所有结果，再筛选特定错误处理（如检查错误类型或状态码）；二是在catch中添加条件判断，仅处理目标错误。

try {  
  const results = await Promise.all([fetch('/api1'), fetch('/api2')]);  
} catch (error) {  
  if (error.message.includes('Network Error')) {  
    // 仅处理网络错误  
    console.error('网络异常:', error);  
  } else {  
    throw error; // 其他错误继续向上传递  
  }  
}