---
title: "Soluciona AxiosError Network Error y averigua cuál de sus 3 causas tienes"
description: "AxiosError: Network Error significa que el navegador no recibió respuesta HTTP. Una conexión rechazada, una cabecera CORS que falta y un host desconocido dan todos ERR_NETWORK."
canonical: "https://logbrew.co/es/errors/axios-network-error"
last_updated: "2026-11-21"
---

# Soluciona AxiosError Network Error y averigua cuál de sus 3 causas tienes

`AxiosError: Network Error` significa que el navegador no recibió respuesta HTTP. Una conexión rechazada, una cabecera CORS que falta y un host desconocido dan todos `ERR_NETWORK`.

Probado el 21 de noviembre de 2026 con axios 1.21.1, Chrome 157, Safari 27.2 y @logbrew/browser 0.1.22

Por [Furkan Erday](https://github.com/furkanerday). Furkan Erday es el fundador de LogBrew. Desarrolla LogBrew con Claude Code y Codex todos los días.

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

## Qué nombra la causa de un `AxiosError`

| Qué salió mal | `error.message` | Consola |
| --- | --- | --- |
| Nada escucha en el puerto | `Network Error` | `ERR_CONNECTION_REFUSED` |
| Sin cabecera `Access-Control-Allow-Origin` | `Network Error` | Política CORS |
| El host no tiene registro DNS | `Network Error` | `ERR_NAME_NOT_RESOLVED` |
| Sin respuesta antes del timeout | `timeout of 1000ms exceeded` | Ninguna línea |
| El servidor respondió 500 | `Request failed with status code 500` | `500` |

5 solicitudes de axios 1.21.1 en Chrome 157.

## Averigua qué causa tienes

### Abre la consola del navegador

Axios rechaza con `Network Error` y el código `ERR_NETWORK` en las 3 causas, y `error.response` es `undefined`. La pila apunta dentro de Axios, no a la causa. La línea de consola que aparece al lado nombra la causa real.

Salida

```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 escucha en ese host y puerto

La consola dice `net::ERR_CONNECTION_REFUSED`. La API no está en marcha, o el puerto de la URL está mal. Arranca la API y luego revisa el puerto.

Salida

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

### La API respondió sin cabecera CORS

La consola dice `blocked by CORS policy`. El servidor respondió, pero el navegador no dejó que la página leyera la respuesta. Axios no recibió respuesta y dio el mismo `Network Error`.

Salida

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

### El nombre de host no se resuelve

La consola dice `net::ERR_NAME_NOT_RESOLVED`. El DNS no tiene registro para el host. Busca una errata en la URL base y revisa la variable de entorno que la guarda en este despliegue.

Salida

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

### Con el adaptador fetch, lee la causa

Con `adapter: "fetch"`, Axios da el mismo `Network Error` y guarda el error del navegador en `error.cause`. Fue `TypeError: Failed to fetch` en Chrome 157 y `TypeError: Load failed` en Safari 27.2.

## Soluciónalo en tu código

### Envía la cabecera CORS desde la API

Responde con `Access-Control-Allow-Origin` con el origen de tu página. En nuestra prueba, el mismo endpoint con esa cabecera respondió 200 y Axios resolvió.

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

### Registra el código, el estado y la URL

Lee `error.code` y `error.response` antes de volver a lanzar el error. Un timeout da `ECONNABORTED`, y un 500 da `ERR_BAD_RESPONSE` con el estado. Solo un fallo de red da `ERR_NETWORK` sin respuesta.

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

Salida

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

### Envía la misma solicitud desde Node.js

Node.js no aplica CORS y nombra el error de red. El puerto cerrado dio `ECONNREFUSED` y el host desconocido `ENOTFOUND`. El endpoint sin cabecera CORS respondió 200. Si la solicitud funciona en Node.js, revisa primero 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);
  }
}
```

Salida

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

## Lo que vimos al probarlo

Servimos una página en `http://127.0.0.1:28180` con axios 1.21.1 y la abrimos en Chrome 157 y Safari 27.2. Una API en `http://127.0.0.1:28181` respondía en 3 rutas, y enviamos 5 solicitudes con un timeout de 1000 ms.

Los 2 navegadores dieron el mismo `message` y el mismo `code` para cada solicitud. Los 3 fallos de red tenían además `request.status` en 0 y ninguna `response`, así que nada en el error los distingue.

|  | `error.message` | `error.code` |
| --- | --- | --- |
| Nada escucha en el puerto | `Network Error` | `ERR_NETWORK` |
| Sin cabecera CORS | `Network Error` | `ERR_NETWORK` |
| El host no tiene registro DNS | `Network Error` | `ERR_NETWORK` |
| Sin respuesta antes del timeout | `timeout of 1000ms exceeded` | `ECONNABORTED` |
| El servidor respondió 500 | `Request failed with status code 500` | `ERR_BAD_RESPONSE` |

## Por qué Axios no distingue las causas

En el navegador, Axios envía la solicitud con `XMLHttpRequest`. MDN dice que su evento `error` se dispara cuando la solicitud encuentra un error, y que JavaScript no puede leer por qué falló una solicitud CORS. Axios rechaza con `Network Error` cuando se dispara ese evento.

La documentación de Axios dice lo mismo. `ERR_NETWORK` cubre problemas de red y CORS, y el navegador no le da el motivo a la página, así que mira la consola del navegador.

axios/axios#383 pidió en julio de 2016 un código o un estado para `Network Error`. Hoy `ERR_NETWORK` es ese código, y cubre las 3 causas.

1. Una conexión rechazada, un bloqueo CORS o un host desconocido
2. El evento `error` de `XMLHttpRequest`, con estado 0
3. `AxiosError: Network Error`

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

## Lo que LogBrew registra

Cada rechazo llegó al SDK como rechazo no gestionado. LogBrew agrupó los 5 en 1 incidencia, `Unhandled promise rejection: AxiosError`, con la clave de agrupación `browser.unhandledrejection:AxiosError:/axios-lab.js`. El mensaje era `redacted`, así que la incidencia no dice qué solicitud falló.

También activamos `installLogBrewBrowserXhrInstrumentation()`, que instalas tú. Añadió 1 span `browser.xhr` por solicitud, con el método y la ruta. Los 3 fallos de red tenían `statusCode` 0 y `errorType` `error`, el timeout tenía `timeout`, y el 500 su estado.

La incidencia también guardó breadcrumbs de las solicitudes anteriores al error, con el método, el host, el puerto y la ruta. Un host o un puerto erróneo en un breadcrumb apunta a la causa, incluso sin span.

|  | `statusCode` | `errorType` |
| --- | --- | --- |
| Nada escucha en el puerto | `0` | `error` |
| Sin cabecera CORS | `0` | `error` |
| El host no tiene registro DNS | `0` | `error` |
| Sin respuesta antes del timeout | `0` | `timeout` |
| El servidor respondió 500 | `500` | No |

## Preguntas frecuentes

### ¿Qué significa AxiosError Network Error?

Axios no recibió respuesta HTTP para la solicitud. En nuestra prueba, una conexión rechazada, una cabecera CORS que falta y un host desconocido dieron todos este mensaje, con el código `ERR_NETWORK`.

### ¿AxiosError Network Error es un error de CORS?

A veces. Una cabecera `Access-Control-Allow-Origin` que falta lo provoca, pero también un servidor caído y un host erróneo. La consola del navegador nombra la causa.

### ¿Por qué la solicitud funciona en Node.js pero no en el navegador?

Node.js no aplica CORS. En nuestra prueba, el endpoint sin cabecera CORS respondió 200 en Node.js y falló con `Network Error` en los 2 navegadores.

### ¿Cómo obtengo el código de estado de un AxiosError?

Lee `error.response?.status`. Un `Network Error` no tiene respuesta, así que no tiene estado. Un 500 da `ERR_BAD_RESPONSE`, y `error.response.status` es 500.

### ¿Qué es ERR_NETWORK en Axios?

`ERR_NETWORK` es el `code` de cada `Network Error`. Un timeout tiene otro código, `ECONNABORTED`, y el mensaje `timeout of 1000ms exceeded` con un timeout de 1000 ms.

## Encuentra la solicitud detrás de cada Network Error

El SDK de navegador de LogBrew guarda cada solicitud como breadcrumb con su host y su ruta, y registra cada `XMLHttpRequest` como span si lo activas. Empieza con el generoso plan gratuito, sin tarjeta.

[Empezar gratis](https://logbrew.co/es)

## Fuentes

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

## Más soluciones a errores

- [Soluciona el error Script error que oculta su mensaje, archivo y línea](https://logbrew.co/es/errors/script-error)
- [Soluciona el error Failed to fetch y distingue sus 3 causas](https://logbrew.co/es/errors/failed-to-fetch)
- [Soluciona java.lang.NullPointerException en Kotlin y Android a partir de su mensaje](https://logbrew.co/es/errors/nullpointerexception)
- [Corrige Minified React error #418 y #185 con el mensaje completo y tu línea de código](https://logbrew.co/es/errors/minified-react-error)
- [Soluciona Cannot use import statement outside a module en el navegador y en Node.js](https://logbrew.co/es/errors/cannot-use-import-statement-outside-a-module)
- [Soluciona el error HTTP 499 y averigua quién dejó de esperar](https://logbrew.co/es/errors/http-499)
- [Errores que reproducimos, y cómo solucionar cada uno](https://logbrew.co/es/errors)
