---
title: "Corrija AxiosError Network Error e descubra qual das 3 causas você tem"
description: "AxiosError: Network Error significa que o navegador não recebeu resposta HTTP. Uma conexão recusada, um header CORS ausente e um host desconhecido dão todos ERR_NETWORK."
canonical: "https://logbrew.co/pt-BR/errors/axios-network-error"
last_updated: "2026-11-21"
---

# Corrija AxiosError Network Error e descubra qual das 3 causas você tem

`AxiosError: Network Error` significa que o navegador não recebeu resposta HTTP. Uma conexão recusada, um header CORS ausente e um host desconhecido dão todos `ERR_NETWORK`.

Testado em 21 de novembro de 2026 com axios 1.21.1, Chrome 157, Safari 27.2 e @logbrew/browser 0.1.22

Por [Furkan Erday](https://github.com/furkanerday). Furkan Erday é o fundador do LogBrew. Ele desenvolve o LogBrew com Claude Code e Codex todos os dias.

Canonical: https://logbrew.co/pt-BR/errors/axios-network-error

## O que nomeia a causa de um `AxiosError`

| O que deu errado | `error.message` | Console |
| --- | --- | --- |
| Nada escuta na porta | `Network Error` | `ERR_CONNECTION_REFUSED` |
| Sem header `Access-Control-Allow-Origin` | `Network Error` | Política de CORS |
| O host não tem registro DNS | `Network Error` | `ERR_NAME_NOT_RESOLVED` |
| Sem resposta antes do timeout | `timeout of 1000ms exceeded` | Nenhuma linha |
| O servidor respondeu 500 | `Request failed with status code 500` | `500` |

5 requisições do axios 1.21.1 no Chrome 157.

## Descubra qual causa você tem

### Abra o console do navegador

O Axios rejeita com `Network Error` e o código `ERR_NETWORK` nas 3 causas, e `error.response` é `undefined`. A stack aponta para dentro do Axios, não para a causa. A linha do console ao lado nomeia a causa real.

Saída

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

### Nada escuta nesse host e porta

O console mostra `net::ERR_CONNECTION_REFUSED`. A API não está rodando, ou a porta na URL está errada. Suba a API e depois confira a porta.

Saída

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

### A API respondeu sem header CORS

O console mostra `blocked by CORS policy`. O servidor respondeu, mas o navegador não deixou a página ler a resposta. O Axios não recebeu resposta e deu o mesmo `Network Error`.

Saída

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

### O nome do host não resolve

O console mostra `net::ERR_NAME_NOT_RESOLVED`. O DNS não tem registro para o host. Procure um erro de digitação na URL base e confira a variável de ambiente que a guarda nesta implantação.

Saída

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

### Com o adapter fetch, leia a causa

Com `adapter: "fetch"`, o Axios dá o mesmo `Network Error` e guarda o erro do navegador em `error.cause`. Foi `TypeError: Failed to fetch` no Chrome 157 e `TypeError: Load failed` no Safari 27.2.

## Corrija no seu código

### Envie o header CORS pela API

Responda com `Access-Control-Allow-Origin` definido para a origem da sua página. No nosso teste, o mesmo endpoint com esse header respondeu 200, e o Axios resolveu.

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

### Registre o código, o status e a URL

Leia `error.code` e `error.response` antes de lançar o erro de novo. Um timeout dá `ECONNABORTED`, e um 500 dá `ERR_BAD_RESPONSE` com o status. Só uma falha de rede dá `ERR_NETWORK` sem resposta.

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

Saída

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

### Envie a mesma requisição pelo Node.js

O Node.js não aplica CORS e nomeia o erro de rede. A porta fechada deu `ECONNREFUSED`, e o host desconhecido deu `ENOTFOUND`. O endpoint sem header CORS respondeu 200. Se a requisição funciona no Node.js, olhe o CORS primeiro.

```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);
  }
}
```

Saída

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

## O que vimos no teste

Servimos uma página em `http://127.0.0.1:28180` com axios 1.21.1 e a abrimos no Chrome 157 e no Safari 27.2. Uma API em `http://127.0.0.1:28181` respondia em 3 caminhos, e enviamos 5 requisições com timeout de 1.000 ms.

Os 2 navegadores deram a mesma `message` e o mesmo `code` para cada requisição. As 3 falhas de rede também tinham `request.status` 0 e nenhuma `response`, então nada no erro as diferencia.

|  | `error.message` | `error.code` |
| --- | --- | --- |
| Nada escuta na porta | `Network Error` | `ERR_NETWORK` |
| Sem header CORS | `Network Error` | `ERR_NETWORK` |
| O host não tem registro DNS | `Network Error` | `ERR_NETWORK` |
| Sem resposta antes do timeout | `timeout of 1000ms exceeded` | `ECONNABORTED` |
| O servidor respondeu 500 | `Request failed with status code 500` | `ERR_BAD_RESPONSE` |

## Por que o Axios não diferencia as causas

No navegador, o Axios envia a requisição com `XMLHttpRequest`. O MDN diz que o evento `error` dele dispara quando a requisição encontra um erro, e que o JavaScript não consegue ler por que uma requisição CORS falhou. O Axios rejeita com `Network Error` quando esse evento dispara.

A documentação do Axios diz o mesmo. `ERR_NETWORK` cobre problemas de rede e CORS, e o navegador não passa o motivo para a página, então olhe o console do navegador.

O axios/axios#383 pediu em julho de 2016 um código ou status para `Network Error`. Hoje `ERR_NETWORK` é esse código, e ele cobre as 3 causas.

1. Uma conexão recusada, um bloqueio CORS ou um host desconhecido
2. O evento `error` do `XMLHttpRequest`, com status 0
3. `AxiosError: Network Error`

- [axios/axios#383](https://github.com/axios/axios/issues/383) Set a code/status for "Network Error". Fechado, 69 comentários.

## O que o LogBrew registra

Cada rejeição chegou ao SDK como rejeição não tratada. O LogBrew juntou as 5 em 1 problema, `Unhandled promise rejection: AxiosError`, com a chave de agrupamento `browser.unhandledrejection:AxiosError:/axios-lab.js`. A mensagem estava `redacted`, então o problema não diz qual requisição falhou.

Também ligamos `installLogBrewBrowserXhrInstrumentation()`, que você instala por conta própria. Ela adicionou 1 span `browser.xhr` por requisição, com o método e o caminho. As 3 falhas de rede tinham `statusCode` 0 e `errorType` `error`, o timeout tinha `timeout`, e o 500 tinha seu status.

O problema também guardou breadcrumbs das requisições antes do erro, com método, host, porta e caminho. Um host ou porta errados em um breadcrumb apontam para a causa, mesmo sem span.

|  | `statusCode` | `errorType` |
| --- | --- | --- |
| Nada escuta na porta | `0` | `error` |
| Sem header CORS | `0` | `error` |
| O host não tem registro DNS | `0` | `error` |
| Sem resposta antes do timeout | `0` | `timeout` |
| O servidor respondeu 500 | `500` | Não |

## Perguntas frequentes

### O que significa AxiosError Network Error?

O Axios não recebeu resposta HTTP para a requisição. No nosso teste, uma conexão recusada, um header CORS ausente e um host desconhecido deram essa mensagem, com o código `ERR_NETWORK`.

### AxiosError Network Error é um erro de CORS?

Às vezes. A falta do header `Access-Control-Allow-Origin` causa o erro, mas um servidor fora do ar e um host errado também. O console do navegador nomeia a causa.

### Por que a requisição funciona no Node.js, mas não no navegador?

O Node.js não aplica CORS. No nosso teste, o endpoint sem header CORS respondeu 200 no Node.js e falhou com `Network Error` nos 2 navegadores.

### Como pego o status code de um AxiosError?

Leia `error.response?.status`. Um `Network Error` não tem resposta, então não tem status. Um 500 dá `ERR_BAD_RESPONSE`, e `error.response.status` é 500.

### O que é ERR_NETWORK no Axios?

`ERR_NETWORK` é o `code` de todo `Network Error`. Um timeout tem outro código, `ECONNABORTED`, e a mensagem `timeout of 1000ms exceeded` com timeout de 1.000 ms.

## Ache a requisição por trás de cada Network Error

O SDK de navegador do LogBrew guarda cada requisição como breadcrumb com host e caminho, e registra cada `XMLHttpRequest` como span quando você liga isso. Comece no plano gratuito generoso, sem cartão.

[Comece grátis](https://logbrew.co/pt-BR)

## Fontes

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

## Mais correções de erros

- [Corrija o erro de script que esconde a mensagem, o arquivo e a linha](https://logbrew.co/pt-BR/errors/script-error)
- [Corrija o erro Failed to fetch e distinga as 3 causas](https://logbrew.co/pt-BR/errors/failed-to-fetch)
- [Corrija java.lang.NullPointerException no Kotlin e no Android a partir da mensagem](https://logbrew.co/pt-BR/errors/nullpointerexception)
- [Corrija Minified React error #418 e #185 com a mensagem completa e a sua linha de código](https://logbrew.co/pt-BR/errors/minified-react-error)
- [Corrija Cannot use import statement outside a module no navegador e no Node.js](https://logbrew.co/pt-BR/errors/cannot-use-import-statement-outside-a-module)
- [Corrija o erro HTTP 499 e descubra quem parou de esperar](https://logbrew.co/pt-BR/errors/http-499)
- [Erros que reproduzimos, e como corrigir cada um](https://logbrew.co/pt-BR/errors)
