---
title: "Risolvi l’errore di rete AxiosError e scopri quale delle 3 cause hai"
description: "AxiosError: Network Error vuol dire che il browser non ha ricevuto una risposta HTTP. Una connessione rifiutata, un header CORS mancante e un host sconosciuto danno tutti ERR_NETWORK."
canonical: "https://logbrew.co/it/errors/axios-network-error"
last_updated: "2026-11-21"
---

# Risolvi l’errore di rete AxiosError e scopri quale delle 3 cause hai

`AxiosError: Network Error` vuol dire che il browser non ha ricevuto una risposta HTTP. Una connessione rifiutata, un header CORS mancante e un host sconosciuto danno tutti `ERR_NETWORK`.

Testato il 21 novembre 2026 con axios 1.21.1, Chrome 157, Safari 27.2 e @logbrew/browser 0.1.22

Di [Furkan Erday](https://github.com/furkanerday). Furkan Erday è il fondatore di LogBrew. Sviluppa LogBrew ogni giorno con Claude Code e Codex.

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

## Cosa indica la causa di un `AxiosError`

| Cosa è andato storto | `error.message` | Console |
| --- | --- | --- |
| Niente in ascolto sulla porta | `Network Error` | `ERR_CONNECTION_REFUSED` |
| Nessun header `Access-Control-Allow-Origin` | `Network Error` | Policy CORS |
| L’host non ha record DNS | `Network Error` | `ERR_NAME_NOT_RESOLVED` |
| Nessuna risposta prima del timeout | `timeout of 1000ms exceeded` | Nessuna riga |
| Il server ha risposto 500 | `Request failed with status code 500` | `500` |

5 richieste da axios 1.21.1 in Chrome 157.

## Scopri quale causa hai

### Apri la console del browser

Axios rifiuta con `Network Error` e il codice `ERR_NETWORK` per tutte e 3 le cause, e `error.response` è `undefined`. Lo stack punta dentro Axios, non alla causa. La riga della console accanto indica la causa vera.

Output

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

### Niente è in ascolto su quell’host e quella porta

La console dice `net::ERR_CONNECTION_REFUSED`. L’API non è avviata, o la porta nell’URL è sbagliata. Avvia l’API, poi controlla la porta.

Output

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

### L’API ha risposto senza header CORS

La console dice `blocked by CORS policy`. Il server ha risposto, ma il browser non ha lasciato leggere la risposta alla pagina. Axios non ha ricevuto risposta e ha dato lo stesso `Network Error`.

Output

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

### Il nome host non si risolve

La console dice `net::ERR_NAME_NOT_RESOLVED`. Il DNS non ha record per l’host. Cerca un refuso nell’URL di base, e controlla la variabile d’ambiente che lo contiene in questo deploy.

Output

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

### Con l’adapter fetch, leggi la causa

Con `adapter: "fetch"`, Axios dà lo stesso `Network Error` e mette l’errore del browser in `error.cause`. Era `TypeError: Failed to fetch` in Chrome 157 e `TypeError: Load failed` in Safari 27.2.

## Risolvi nel tuo codice

### Invia l’header CORS dall’API

Rispondi con `Access-Control-Allow-Origin` impostato sull’origine della tua pagina. Nel nostro test lo stesso endpoint con quell’header ha risposto 200, e Axios ha risolto.

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

### Registra il codice, lo status e l’URL

Leggi `error.code` e `error.response` prima di rilanciare l’errore. Un timeout dà `ECONNABORTED`, e un 500 dà `ERR_BAD_RESPONSE` con lo status. Solo un guasto di rete dà `ERR_NETWORK` senza risposta.

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

Output

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

### Invia la stessa richiesta da Node.js

Node.js non applica CORS e indica l’errore di rete. La porta chiusa ha dato `ECONNREFUSED`, e l’host sconosciuto `ENOTFOUND`. L’endpoint senza header CORS ha risposto 200. Se la richiesta funziona in Node.js, guarda prima 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);
  }
}
```

Output

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

## Cosa abbiamo visto nei test

Abbiamo servito una pagina su `http://127.0.0.1:28180` con axios 1.21.1 e l’abbiamo aperta in Chrome 157 e Safari 27.2. Un’API su `http://127.0.0.1:28181` rispondeva su 3 percorsi, e abbiamo inviato 5 richieste con un timeout di 1.000 ms.

Entrambi i browser hanno dato lo stesso `message` e lo stesso `code` per ogni richiesta. I 3 guasti di rete avevano anche `request.status` a 0 e nessuna `response`, quindi niente nell’errore li distingue.

|  | `error.message` | `error.code` |
| --- | --- | --- |
| Niente in ascolto sulla porta | `Network Error` | `ERR_NETWORK` |
| Nessun header CORS | `Network Error` | `ERR_NETWORK` |
| L’host non ha record DNS | `Network Error` | `ERR_NETWORK` |
| Nessuna risposta prima del timeout | `timeout of 1000ms exceeded` | `ECONNABORTED` |
| Il server ha risposto 500 | `Request failed with status code 500` | `ERR_BAD_RESPONSE` |

## Perché Axios non distingue le cause

Nel browser, Axios invia la richiesta con `XMLHttpRequest`. MDN dice che il suo evento `error` scatta quando la richiesta incontra un errore, e che JavaScript non può leggere perché una richiesta CORS è fallita. Axios rifiuta con `Network Error` quando scatta quell’evento.

La documentazione di Axios dice lo stesso. `ERR_NETWORK` copre i problemi di rete e CORS, e il browser non passa il motivo alla pagina, quindi guarda la console del browser.

axios/axios#383 chiedeva a luglio 2016 un codice o uno status per `Network Error`. Oggi `ERR_NETWORK` è quel codice, e copre tutte e 3 le cause.

1. Una connessione rifiutata, un blocco CORS o un host sconosciuto
2. L’evento `error` di `XMLHttpRequest`, con status 0
3. `AxiosError: Network Error`

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

## Cosa registra LogBrew

Ogni rejection è arrivata all’SDK come rejection non gestita. LogBrew ha messo tutte e 5 in 1 problema, `Unhandled promise rejection: AxiosError`, con la chiave di raggruppamento `browser.unhandledrejection:AxiosError:/axios-lab.js`. Il messaggio era `redacted`, quindi il problema non dice quale richiesta è fallita.

Abbiamo anche attivato `installLogBrewBrowserXhrInstrumentation()`, che installi tu. Ha aggiunto 1 span `browser.xhr` per ogni richiesta, con il metodo e il percorso. I 3 guasti di rete avevano `statusCode` 0 ed `errorType` `error`, il timeout aveva `timeout`, e il 500 il suo status.

Il problema ha anche tenuto i breadcrumb delle richieste prima dell’errore, con metodo, host, porta e percorso. Un host o una porta sbagliati in un breadcrumb puntano alla causa, anche senza span.

|  | `statusCode` | `errorType` |
| --- | --- | --- |
| Niente in ascolto sulla porta | `0` | `error` |
| Nessun header CORS | `0` | `error` |
| L’host non ha record DNS | `0` | `error` |
| Nessuna risposta prima del timeout | `0` | `timeout` |
| Il server ha risposto 500 | `500` | No |

## Domande frequenti

### Cosa vuol dire l’errore di rete AxiosError?

Axios non ha ricevuto una risposta HTTP per la richiesta. Nel nostro test una connessione rifiutata, un header CORS mancante e un host sconosciuto hanno dato tutti questo messaggio, con il codice `ERR_NETWORK`.

### L’errore di rete AxiosError è un errore CORS?

A volte. Un header `Access-Control-Allow-Origin` mancante lo causa, ma anche un server spento e un host sbagliato. La console del browser indica la causa.

### Perché la richiesta funziona in Node.js ma non nel browser?

Node.js non applica CORS. Nel nostro test l’endpoint senza header CORS ha risposto 200 in Node.js ed è fallito con `Network Error` in entrambi i browser.

### Come ottengo lo status code da un AxiosError?

Leggi `error.response?.status`. Un `Network Error` non ha risposta, quindi non ha status. Un 500 dà `ERR_BAD_RESPONSE`, ed `error.response.status` è 500.

### Cos’è ERR_NETWORK in Axios?

`ERR_NETWORK` è il `code` di ogni `Network Error`. Un timeout ha un altro codice, `ECONNABORTED`, e il messaggio `timeout of 1000ms exceeded` con un timeout di 1.000 ms.

## Trova la richiesta dietro ogni errore di rete

L’SDK per browser di LogBrew tiene ogni richiesta come breadcrumb con host e percorso, e registra ogni `XMLHttpRequest` come span quando lo attivi. Inizia con il generoso piano gratuito, senza carta.

[Inizia gratis](https://logbrew.co/it)

## Fonti

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

## Altre soluzioni agli errori

- [Risolvi l’errore di script che nasconde messaggio, file e riga](https://logbrew.co/it/errors/script-error)
- [Risolvi l’errore Failed to fetch e distingui le sue 3 cause](https://logbrew.co/it/errors/failed-to-fetch)
- [Risolvi java.lang.NullPointerException in Kotlin e Android partendo dal messaggio](https://logbrew.co/it/errors/nullpointerexception)
- [Risolvi l’errore Minified React #418 e #185 con il messaggio completo e la tua riga di codice](https://logbrew.co/it/errors/minified-react-error)
- [Risolvi Cannot use import statement outside a module nel browser e in Node.js](https://logbrew.co/it/errors/cannot-use-import-statement-outside-a-module)
- [Risolvi l’errore HTTP 499 e scopri chi ha smesso di aspettare](https://logbrew.co/it/errors/http-499)
- [Errori che abbiamo riprodotto, e come risolvere ciascuno](https://logbrew.co/it/errors)
