---
title: "修复 AxiosError Network Error，找出你遇到的是 3 种原因中的哪一种"
description: "AxiosError: Network Error 表示浏览器没有收到 HTTP 响应。连接被拒绝、缺少 CORS 响应头、主机不存在，都会给出 ERR_NETWORK。"
canonical: "https://logbrew.co/zh-Hans/errors/axios-network-error"
last_updated: "2026-11-21"
---

# 修复 AxiosError Network Error，找出你遇到的是 3 种原因中的哪一种

`AxiosError: Network Error` 表示浏览器没有收到 HTTP 响应。连接被拒绝、缺少 CORS 响应头、主机不存在，都会给出 `ERR_NETWORK`。

2026年11月21日 用 axios 1.21.1、Chrome 157、Safari 27.2和@logbrew/browser 0.1.22 实测

作者 [Furkan Erday](https://github.com/furkanerday). Furkan Erday 是 LogBrew 的创始人，每天用 Claude Code 和 Codex 开发 LogBrew。

Canonical: https://logbrew.co/zh-Hans/errors/axios-network-error

## 什么能说出 `AxiosError` 的原因

| 出了什么问题 | `error.message` | 控制台 |
| --- | --- | --- |
| 端口上没有程序在监听 | `Network Error` | `ERR_CONNECTION_REFUSED` |
| 没有 `Access-Control-Allow-Origin` 响应头 | `Network Error` | CORS 策略 |
| 主机没有 DNS 记录 | `Network Error` | `ERR_NAME_NOT_RESOLVED` |
| 超时前没有响应 | `timeout of 1000ms exceeded` | 没有对应行 |
| 服务器返回 500 | `Request failed with status code 500` | `500` |

在 Chrome 157 中由 axios 1.21.1 发出的 5 个请求。

## 找出你遇到的是哪种原因

### 打开浏览器控制台

3 种原因下，Axios 都以 `Network Error` 和代码 `ERR_NETWORK` 拒绝，`error.response` 为 `undefined`。堆栈指向 Axios 内部，而不是原因。旁边的控制台行才说出真正的原因。

输出

```text
Uncaught (in promise) AxiosError: Network Error
    at XMLHttpRequest.handleError (http://127.0.0.1:28180/axios-lab.js:2491:19)
    at Axios.request (http://127.0.0.1:28180/axios-lab.js:3547:43)
```

### 该主机和端口上没有程序在监听

控制台显示 `net::ERR_CONNECTION_REFUSED`。API 没有运行，或 URL 中的端口写错了。先启动 API，再检查端口。

输出

```text
Failed to load resource: net::ERR_CONNECTION_REFUSED
```

### API 的响应没有 CORS 响应头

控制台显示 `blocked by CORS policy`。服务器已经响应，但浏览器不让页面读取响应。Axios 没有收到响应，给出同样的 `Network Error`。

输出

```text
Access to XMLHttpRequest at 'http://127.0.0.1:28181/api/taps' from origin 'http://127.0.0.1:28180' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.
```

### 主机名无法解析

控制台显示 `net::ERR_NAME_NOT_RESOLVED`。DNS 中没有该主机的记录。检查基础 URL 有没有拼写错误，以及这次部署中保存它的环境变量。

输出

```text
Failed to load resource: net::ERR_NAME_NOT_RESOLVED
```

### 使用 fetch 适配器时，读取 cause

使用 `adapter: "fetch"` 时，Axios 给出同样的 `Network Error`，并把浏览器的错误放在 `error.cause` 中。在 Chrome 157 中它是 `TypeError: Failed to fetch`，在 Safari 27.2 中是 `TypeError: Load failed`。

## 在你的代码里修复

### 从 API 发送 CORS 响应头

响应时带上 `Access-Control-Allow-Origin`，值设为你页面的源。在我们的测试中，同一个接口加上这个响应头后返回 200，Axios 也正常返回了结果。

```bash
Access-Control-Allow-Origin: https://app.example.com
```

### 记录代码、状态和 URL

在重新抛出错误之前，读取 `error.code` 和 `error.response`。超时给出 `ECONNABORTED`，500 给出带状态的 `ERR_BAD_RESPONSE`。只有网络故障才会给出没有响应的 `ERR_NETWORK`。

```bash
async function getTaps(url) {
  try {
    return await axios.get(url, { timeout: 1000 });
  } catch (error) {
    if (!axios.isAxiosError(error)) throw error;
    console.error(error.code, error.response?.status ?? "no response", error.config?.url);
    throw error;
  }
}
```

输出

```text
ERR_NETWORK no response http://127.0.0.1:28182/api/taps
ECONNABORTED no response http://127.0.0.1:28181/api/slow
ERR_BAD_RESPONSE 500 http://127.0.0.1:28181/api/fail
```

### 从 Node.js 发送同一个请求

Node.js 不执行 CORS，并会说出网络错误的名称。关闭的端口给出 `ECONNREFUSED`，不存在的主机给出 `ENOTFOUND`。没有 CORS 响应头的接口返回了 200。所以如果请求在 Node.js 中能成功，先检查 CORS。

```bash
import axios from "axios";

for (const url of ["http://127.0.0.1:28182/api/taps", "http://127.0.0.1:28181/api/taps", "http://keg.invalid/api/taps"]) {
  try {
    const response = await axios.get(url);
    console.log(response.status, url);
  } catch (error) {
    console.log(error.code, error.message);
  }
}
```

输出

```text
ECONNREFUSED connect ECONNREFUSED 127.0.0.1:28182
200 http://127.0.0.1:28181/api/taps
ENOTFOUND getaddrinfo ENOTFOUND keg.invalid
```

## 我们实测看到的结果

我们在 `http://127.0.0.1:28180` 提供一个使用 axios 1.21.1 的页面，并用 Chrome 157 和 Safari 27.2 打开。`http://127.0.0.1:28181` 上的 API 响应 3 个路径，我们以 1,000 ms 的超时发送了 5 个请求。

两个浏览器对每个请求给出的 `message` 和 `code` 都相同。3 个网络故障的 `request.status` 都是 0，也都没有 `response`，所以错误本身无法区分它们。

|  | `error.message` | `error.code` |
| --- | --- | --- |
| 端口上没有程序在监听 | `Network Error` | `ERR_NETWORK` |
| 没有 CORS 响应头 | `Network Error` | `ERR_NETWORK` |
| 主机没有 DNS 记录 | `Network Error` | `ERR_NETWORK` |
| 超时前没有响应 | `timeout of 1000ms exceeded` | `ECONNABORTED` |
| 服务器返回 500 | `Request failed with status code 500` | `ERR_BAD_RESPONSE` |

## 为什么 Axios 分不清原因

在浏览器中，Axios 用 `XMLHttpRequest` 发送请求。MDN 说，请求遇到错误时会触发它的 `error` 事件，而 JavaScript 无法读取 CORS 请求失败的原因。这个事件一触发，Axios 就以 `Network Error` 拒绝。

Axios 文档也这么说。`ERR_NETWORK` 涵盖网络问题和 CORS，浏览器不会把原因交给页面，所以请查看浏览器控制台。

axios/axios#383 在 2016 年 7 月请求为 `Network Error` 提供代码或状态。如今 `ERR_NETWORK` 就是这个代码，它涵盖全部 3 种原因。

1. 连接被拒绝、CORS 拦截或主机不存在
2. `error` 事件（`XMLHttpRequest`，状态为 0）
3. `AxiosError: Network Error`

- [axios/axios#383](https://github.com/axios/axios/issues/383) Set a code/status for "Network Error". 已关闭, 69 条评论.

## LogBrew 记录了什么

每次拒绝都以未处理的拒绝到达 SDK。LogBrew 把 5 次全部归入 1 个问题 `Unhandled promise rejection: AxiosError`，聚合键为 `browser.unhandledrejection:AxiosError:/axios-lab.js`。消息为 `redacted`，所以问题本身不说明哪个请求失败了。

我们还开启了 `installLogBrewBrowserXhrInstrumentation()`，这需要你自己安装。它为每个请求加上 1 个 `browser.xhr` Span，带有方法和路径。3 个网络故障的 `statusCode` 为 0，`errorType` 为 `error`，超时为 `timeout`，500 则带有它的状态。

问题还保留了出错前各请求的面包屑，带有方法、主机、端口和路径。面包屑里的主机或端口不对，就能指出原因，即使没有 Span。

|  | `statusCode` | `errorType` |
| --- | --- | --- |
| 端口上没有程序在监听 | `0` | `error` |
| 没有 CORS 响应头 | `0` | `error` |
| 主机没有 DNS 记录 | `0` | `error` |
| 超时前没有响应 | `0` | `timeout` |
| 服务器返回 500 | `500` | 否 |

## 常见问题

### AxiosError Network Error 是什么意思？

Axios 没有收到该请求的 HTTP 响应。在我们的测试中，连接被拒绝、缺少 CORS 响应头和主机不存在都给出这条消息，代码为 `ERR_NETWORK`。

### AxiosError Network Error 是 CORS 错误吗？

有时是。缺少 `Access-Control-Allow-Origin` 响应头会引发它，但服务器宕机和主机写错也会。浏览器控制台会说出原因。

### 为什么请求在 Node.js 中能成功，在浏览器中却失败？

Node.js 不执行 CORS。在我们的测试中，没有 CORS 响应头的接口在 Node.js 中返回 200，在两个浏览器中都以 `Network Error` 失败。

### 怎样从 AxiosError 中拿到状态码？

读取 `error.response?.status`。`Network Error` 没有响应，所以也没有状态。500 给出 `ERR_BAD_RESPONSE`，`error.response.status` 为 500。

### Axios 中的 ERR_NETWORK 是什么？

`ERR_NETWORK` 是每个 `Network Error` 的 `code`。超时的代码不同，是 `ECONNABORTED`，超时为 1,000 ms 时消息是 `timeout of 1000ms exceeded`。

## 找到每个 Network Error 背后的请求

LogBrew 浏览器 SDK 把每个请求保留为带主机和路径的面包屑，开启后还会把每个 `XMLHttpRequest` 记录为 Span。免费额度充足，无需绑卡。

[免费开始](https://logbrew.co/zh-Hans)

## 参考来源

- [axios docs, Error handling](https://axios.rest/pages/advanced/error-handling)
- [MDN, XMLHttpRequestEventTarget: error event](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/error_event)
- [MDN, CORS errors](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS/Errors)
- [axios/axios#383](https://github.com/axios/axios/issues/383)

## 更多错误修复

- [修复隐藏了消息、文件和行号的脚本错误](https://logbrew.co/zh-Hans/errors/script-error)
- [修复 Failed to fetch 错误，分清它的 3 种原因](https://logbrew.co/zh-Hans/errors/failed-to-fetch)
- [从消息入手修复 Kotlin 和 Android 中的 java.lang.NullPointerException](https://logbrew.co/zh-Hans/errors/nullpointerexception)
- [从完整消息和你自己的代码行入手修复 Minified React error #418 和 #185](https://logbrew.co/zh-Hans/errors/minified-react-error)
- [在浏览器和 Node.js 中修复 Cannot use import statement outside a module](https://logbrew.co/zh-Hans/errors/cannot-use-import-statement-outside-a-module)
- [修复 HTTP 499 错误，找出是谁先停止了等待](https://logbrew.co/zh-Hans/errors/http-499)
- [我们复现过的错误，以及每个错误的修复方法](https://logbrew.co/zh-Hans/errors)
