错误处理

axios 可能会抛出多种不同类型的错误，有些来自 axios 本身，有些来自服务器或客户端。下表列出了所抛出错误的基本结构：

属性	说明
message	错误信息的简要摘要，以及失败时的状态码。
name	定义错误的来源，对于 axios 来说始终是 `AxiosError`。
stack	提供错误的堆栈跟踪。
config	包含用户在发起请求时定义的特定实例配置的 axios 配置对象。
code	表示 axios 内部识别的错误，下表列出了 axios 内部错误的具体说明。
status	HTTP 响应状态码。常见 HTTP 响应状态码的含义请参阅此处。

以下是 axios 内部可能出现的错误列表：

错误代码	说明
ERR_BAD_OPTION_VALUE	axios 配置中提供了无效或不支持的值。
ERR_BAD_OPTION	axios 配置中提供了无效选项。
ECONNABORTED	通常表示请求已超时（除非设置了 `transitional.clarifyTimeoutError`）或被浏览器或其插件中止。
ETIMEDOUT	请求因超过 axios 默认时限而超时。必须将 `transitional.clarifyTimeoutError` 设置为 `true`，否则会抛出通用的 `ECONNABORTED` 错误。
ERR_NETWORK	网络相关问题。在浏览器中，此错误也可能由 CORS 或混合内容策略违规引起。出于安全考虑，浏览器不允许 JS 代码获知错误的真实原因，请检查控制台。
ERR_FR_TOO_MANY_REDIRECTS	请求重定向次数过多，超过了 axios 配置中指定的最大重定向次数。
ERR_DEPRECATED	使用了 axios 中已废弃的功能或方法。
ERR_BAD_RESPONSE	响应无法正确解析或格式异常，通常与 `5xx` 状态码的响应有关。
ERR_BAD_REQUEST	请求格式异常或缺少必要参数，通常与 `4xx` 状态码的响应有关。
ERR_CANCELED	功能或方法被用户通过 AbortSignal（或 CancelToken）显式取消。
ERR_NOT_SUPPORT	当前 axios 环境不支持该功能或方法。
ERR_INVALID_URL	axios 请求提供了无效的 URL。
ERR_FORM_DATA_DEPTH_EXCEEDED	在序列化 `params` 或表单数据时，对象超过了配置的 `maxDepth`，默认上限为 100 层。详见 `paramsSerializer` 和 `formSerializer`。

处理错误

axios 的默认行为是在请求失败时 reject Promise。不过，你也可以捕获错误并按需处理。以下是捕获错误的示例：

axios.get("/user/12345").catch(function (error) {
  if (error.response) {
    // 请求已发出，服务器返回了不在 2xx 范围内的状态码
    console.log(error.response.data);
    console.log(error.response.status);
    console.log(error.response.headers);
  } else if (error.request) {
    // 请求已发出，但未收到响应
    // `error.request` 在浏览器中是 XMLHttpRequest 实例，在 node.js 中是 http.ClientRequest 实例
    console.log(error.request);
  } else {
    // 在设置请求时触发了错误
    console.log("Error", error.message);
  }
  console.log(error.config);
});

使用 validateStatus 配置选项，可以覆盖默认条件（status >= 200 && status < 300），自定义应当抛出错误的 HTTP 状态码。

axios.get("/user/12345", {
  validateStatus: function (status) {
    return status < 500; // 仅在状态码小于 500 时 resolve
  },
});

使用 toJSON 方法，可以获取包含更多错误信息的对象。

axios.get("/user/12345").catch(function (error) {
  console.log(error.toJSON());
});

为避免从 error.config 中泄露敏感信息，可在请求配置中传入 redact 数组。当调用 AxiosError#toJSON() 时，匹配的配置键会在任意深度上以不区分大小写的方式被脱敏。

axios.get("/user/12345", {
  headers: { Authorization: "Bearer token" },
  redact: ["authorization"]
}).catch(function (error) {
  console.log(error.toJSON().config.headers.Authorization); // [REDACTED ****]
});

处理超时

当请求超过其配置的 timeout 时，axios 默认会以 ECONNABORTED 拒绝。设置 transitional.clarifyTimeoutError: true 可改为收到 ETIMEDOUT，便于将超时错误与其他中止情况区分开。

async function fetchWithTimeout() {
  try {
    const response = await axios.get("https://example.com/data", {
      timeout: 5000, // 5 秒
      transitional: {
        // 如果你更倾向于使用 ETIMEDOUT 而非 ECONNABORTED，请设置为 true
        clarifyTimeoutError: true,
      },
    });

    console.log("Response:", response.data);
  } catch (error) {
    if (axios.isAxiosError(error)) {
      if (error.code === "ECONNABORTED" || error.code === "ETIMEDOUT") {
        console.error("请求超时，请重试。");
        return;
      }

      console.error("Axios 错误：", error.message);
      return;
    }

    console.error("意外错误：", error);
  }
}

在生产环境中始终设置 timeout

若不设置超时，停滞的请求可能会无限挂起。匹配的配置选项请参阅 timeout 与 transitional.clarifyTimeoutError。

错误处理 ​

处理错误 ​

处理超时 ​

错误处理

处理错误

处理超时