---
title: "AxiosError Network Error 해결하고 3가지 원인 중 어느 것인지 찾기"
description: "AxiosError: Network Error는 브라우저가 HTTP 응답을 받지 못했다는 뜻이에요. 연결 거부, CORS 헤더 누락, 없는 호스트 모두 ERR_NETWORK를 내요."
canonical: "https://logbrew.co/ko/errors/axios-network-error"
last_updated: "2026-11-21"
---

# AxiosError Network Error 해결하고 3가지 원인 중 어느 것인지 찾기

`AxiosError: Network Error`는 브라우저가 HTTP 응답을 받지 못했다는 뜻이에요. 연결 거부, CORS 헤더 누락, 없는 호스트 모두 `ERR_NETWORK`를 내요.

axios 1.21.1, Chrome 157, Safari 27.2 및 @logbrew/browser 0.1.22 환경에서 2026년 11월 21일에 테스트

글 [Furkan Erday](https://github.com/furkanerday). LogBrew 창업자 Furkan Erday. 매일 Claude Code와 Codex로 LogBrew를 만들어요.

Canonical: https://logbrew.co/ko/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에 오타가 있는지, 이번 배포에서 그 URL을 담은 환경 변수를 확인하세요.

출력

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

### fetch 어댑터에서는 원인 읽기

`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
```

## 직접 테스트해 보니

axios 1.21.1을 쓰는 페이지를 `http://127.0.0.1:28180`에서 제공하고 Chrome 157과 Safari 27.2에서 열었어요. `http://127.0.0.1:28181`의 API가 경로 3개에 응답했고, 타임아웃 1,000ms로 요청 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건 모두를 그룹화 키 `browser.unhandledrejection:AxiosError:/axios-lab.js`로 이슈 1개 `Unhandled promise rejection: AxiosError`에 모았어요. 메시지는 `redacted`라서, 이슈만으로는 어떤 요청이 실패했는지 알 수 없어요.

`installLogBrewBrowserXhrInstrumentation()`도 켰어요. 이건 직접 설치해야 해요. 요청마다 메서드와 경로가 담긴 `browser.xhr` 스팬이 1개씩 추가됐어요. 네트워크 장애 3건은 `statusCode`가 0이고 `errorType`이 `error`였고, 타임아웃은 `timeout`, 500은 그 상태였어요.

이슈에는 오류 전 요청들의 브레드크럼도 메서드, 호스트, 포트, 경로와 함께 남았어요. 브레드크럼의 호스트나 포트가 틀렸다면 스팬이 없어도 원인을 알 수 있어요.

|  | `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,000ms면 메시지는 `timeout of 1000ms exceeded`예요.

## Network Error마다 원인이 된 요청 찾기

LogBrew 브라우저 SDK는 요청마다 호스트와 경로를 담은 브레드크럼을 남기고, 켜 두면 `XMLHttpRequest`마다 스팬으로 기록해요. 넉넉한 무료 요금제로 시작하세요. 카드 등록은 필요 없어요.

[무료로 시작](https://logbrew.co/ko)

## 출처

- [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)

## 오류 해결법 더 보기

- [메시지와 파일, 줄을 숨기는 스크립트 오류 Script error 해결하기](https://logbrew.co/ko/errors/script-error)
- [Failed to fetch 오류를 고치고 원인 3가지를 구분하는 방법](https://logbrew.co/ko/errors/failed-to-fetch)
- [Kotlin과 Android의 java.lang.NullPointerException을 메시지로 해결하기](https://logbrew.co/ko/errors/nullpointerexception)
- [Minified React error #418과 #185를 전체 메시지와 내 코드 줄로 해결하기](https://logbrew.co/ko/errors/minified-react-error)
- [Cannot use import statement outside a module을 브라우저와 Node.js에서 해결하기](https://logbrew.co/ko/errors/cannot-use-import-statement-outside-a-module)
- [HTTP 499 오류를 해결하고 누가 먼저 기다리기를 멈췄는지 찾기](https://logbrew.co/ko/errors/http-499)
- [직접 재현한 오류와 각각의 해결법](https://logbrew.co/ko/errors)
