Node.js 使用 async await 调用第三方 API 超时报错怎么统一处理？

在 Node.js 中使用 async await 调用第三方 API 超时报错，最推荐通过请求库配置超时参数或使用 Promise.race 包装原生请求，并在外层统一包裹 try catch 捕获错误。适用所有基于 HTTP 的网络请求场景，风险边界在于需区分连接超时与响应超时，避免误杀慢查询。

先说结论：统一处理超时的核心是设定明确的毫秒数阈值，并在请求发起层拦截异常，避免错误渗透到业务逻辑层。

适合：使用 Axios、Got 等请求库或原生 http 模块的场景
先看：区分 socket 超时与整体响应超时，配置需覆盖两者
建议：在全局拦截器或统一封装函数中处理，不要分散在每个调用点

快速处理思路

若使用 Axios 等库，直接在配置项设置 timeout 字段；若使用原生 fetch 或 http，需手动创建超时 Promise 进行竞态处理。

// Axios 配置示例
const response = await axios.get(url, { timeout: 5000 });

// 原生 fetch 超时包装
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), 5000);
try {
  const response = await fetch(url, { signal: controller.signal });
  clearTimeout(timeoutId);
} catch (error) {
  // 处理超时错误
}

为什么会这样

超时报错本质是网络请求在指定时间内未完成握手或数据接收，导致事件循环中的回调未被触发。

Node.js 是单线程事件驱动模型，HTTP 请求依赖底层 libuv 线程池处理 DNS 解析和 TCP 连接。若第三方服务响应慢或网络波动，请求挂起会占用文件描述符资源。未设置超时会导致请求无限期等待，最终可能耗尽系统资源或触发上游网关报错。

分步处理

第一步是选择请求库并配置基础超时参数，第二步是封装统一错误处理函数，第三步是接入全局日志监控。

Node.js 使用 async await 调用第三方 API 超时报错怎么统一处理？

步骤 1：配置请求超时
在初始化请求实例时设定 timeout 值，建议设置在 3000ms 至 10000ms 之间，具体取决于第三方 SLA。

步骤 2：统一捕获错误
使用 try catch 包裹 async 函数，判断 error.code 是否为 ECONNABORTED 或 ETIMEDOUT。

try {
  await apiCall();
} catch (err) {
  if (err.code === 'ECONNABORTED' || err.message.includes('timeout')) {
    console.error('请求超时');
  }
}

步骤 3：设置重试机制（可选）
对于幂等接口，可在捕获超时后增加指数退避重试，避免瞬时网络波动导致失败。

怎么验证是否生效

通过模拟延迟接口或断网环境，观察日志是否输出预设的超时错误信息。

检查点 1：运行脚本调用一个故意延迟超过阈值的测试接口，确认 catch 块被触发。
检查点 2：查看应用日志，确认错误类型标记为 Timeout 而非 500 内部错误。
检查点 3：监控进程文件描述符数量，确认超时后连接已正确关闭，无泄漏。

常见坑

容易出错的点集中在超时类型混淆和未清除定时器。

混淆 DNS 超时与响应超时：部分库需分别配置 dns.lookup 和 request timeout。
忘记清除定时器：使用 setTimeout 包装 fetch 时，若请求成功需 clearTimeout，否则会导致内存泄漏。
全局 Unhandled Rejection：若 async 函数未 await 或未 catch，超时 Promise rejection 会导致进程退出。

常见问题

超时错误码 ECONNABORTED 代表什么？

代表客户端主动取消了请求，通常是因为达到了预设的 timeout 阈值。

如何区分连接超时和读取超时？

连接超时发生在 TCP 握手阶段，读取超时发生在接收数据阶段，需查阅所用库的文档配置不同参数。

生产环境建议设置多少毫秒超时？

公开资料中没有看到可靠的量化数据，通常建议根据第三方服务承诺的响应时间增加 50% 余量。

参考来源

Node.js Official Documentation, Timers and AbortController, https://nodejs.org/api/
Axios GitHub Repository, Request Config, https://axios-http.com/