---
title: "AxiosError Network Error beheben und herausfinden, welche der 3 Ursachen du hast"
description: "AxiosError: Network Error heißt, der Browser bekam keine HTTP-Antwort. Eine abgelehnte Verbindung, ein fehlender CORS-Header und ein unbekannter Host geben alle ERR_NETWORK."
canonical: "https://logbrew.co/de/errors/axios-network-error"
last_updated: "2026-11-21"
---

# AxiosError Network Error beheben und herausfinden, welche der 3 Ursachen du hast

`AxiosError: Network Error` heißt, der Browser bekam keine HTTP-Antwort. Eine abgelehnte Verbindung, ein fehlender CORS-Header und ein unbekannter Host geben alle `ERR_NETWORK`.

Getestet am 21. November 2026 mit axios 1.21.1, Chrome 157, Safari 27.2 und @logbrew/browser 0.1.22

Von [Furkan Erday](https://github.com/furkanerday). Furkan Erday hat LogBrew gegründet. Er entwickelt LogBrew jeden Tag mit Claude Code und Codex.

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

## Was die Ursache eines `AxiosError` nennt

| Was schiefging | `error.message` | Konsole |
| --- | --- | --- |
| Auf dem Port lauscht nichts | `Network Error` | `ERR_CONNECTION_REFUSED` |
| Kein `Access-Control-Allow-Origin`-Header | `Network Error` | CORS-Richtlinie |
| Der Host hat keinen DNS-Eintrag | `Network Error` | `ERR_NAME_NOT_RESOLVED` |
| Keine Antwort vor dem Timeout | `timeout of 1000ms exceeded` | Keine Zeile |
| Der Server antwortete 500 | `Request failed with status code 500` | `500` |

5 Anfragen von axios 1.21.1 in Chrome 157.

## Herausfinden, welche Ursache du hast

### Die Browser-Konsole öffnen

Axios lehnt bei allen 3 Ursachen mit `Network Error` und dem Code `ERR_NETWORK` ab, und `error.response` ist `undefined`. Der Stack zeigt in Axios hinein, nicht auf die Ursache. Die Konsolenzeile daneben nennt die echte Ursache.

Ausgabe

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

### Auf diesem Host und Port lauscht nichts

Die Konsole meldet `net::ERR_CONNECTION_REFUSED`. Die API läuft nicht, oder der Port in der URL ist falsch. Starte die API und prüfe dann den Port.

Ausgabe

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

### Die API hat ohne CORS-Header geantwortet

Die Konsole meldet `blocked by CORS policy`. Der Server hat geantwortet, aber der Browser ließ die Seite die Antwort nicht lesen. Axios bekam keine Antwort und gab dasselbe `Network Error` aus.

Ausgabe

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

### Der Hostname lässt sich nicht auflösen

Die Konsole meldet `net::ERR_NAME_NOT_RESOLVED`. Im DNS gibt es keinen Eintrag für den Host. Prüfe die Basis-URL auf Tippfehler und die Umgebungsvariable, die sie in diesem Deployment enthält.

Ausgabe

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

### Mit dem fetch-Adapter die Ursache lesen

Mit `adapter: "fetch"` gibt Axios dasselbe `Network Error` aus und legt den Fehler des Browsers in `error.cause` ab. Das war `TypeError: Failed to fetch` in Chrome 157 und `TypeError: Load failed` in Safari 27.2.

## In deinem Code beheben

### Den CORS-Header von der API senden

Antworte mit `Access-Control-Allow-Origin` und dem Origin deiner Seite. In unserem Test antwortete derselbe Endpunkt mit diesem Header 200, und Axios löste auf.

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

### Code, Status und URL loggen

Lies `error.code` und `error.response`, bevor du den Fehler weiterwirfst. Ein Timeout gibt `ECONNABORTED`, ein 500 gibt `ERR_BAD_RESPONSE` mit dem Status. Nur ein Netzwerkfehler gibt `ERR_NETWORK` ohne Antwort.

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

Ausgabe

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

### Dieselbe Anfrage aus Node.js senden

Node.js wendet kein CORS an und nennt den Netzwerkfehler. Der geschlossene Port gab `ECONNREFUSED`, der unbekannte Host `ENOTFOUND`. Der Endpunkt ohne CORS-Header antwortete 200. Klappt die Anfrage in Node.js, prüfe also zuerst 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);
  }
}
```

Ausgabe

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

## Was wir beim Testen gesehen haben

Wir haben eine Seite unter `http://127.0.0.1:28180` mit axios 1.21.1 ausgeliefert und in Chrome 157 und Safari 27.2 geöffnet. Eine API unter `http://127.0.0.1:28181` beantwortete 3 Pfade, und wir haben 5 Anfragen mit einem Timeout von 1.000 ms gesendet.

Beide Browser gaben für jede Anfrage dieselbe `message` und denselben `code`. Die 3 Netzwerkfehler hatten außerdem `request.status` 0 und keine `response`, also unterscheidet sie nichts im Fehler.

|  | `error.message` | `error.code` |
| --- | --- | --- |
| Auf dem Port lauscht nichts | `Network Error` | `ERR_NETWORK` |
| Kein CORS-Header | `Network Error` | `ERR_NETWORK` |
| Der Host hat keinen DNS-Eintrag | `Network Error` | `ERR_NETWORK` |
| Keine Antwort vor dem Timeout | `timeout of 1000ms exceeded` | `ECONNABORTED` |
| Der Server antwortete 500 | `Request failed with status code 500` | `ERR_BAD_RESPONSE` |

## Warum Axios die Ursachen nicht unterscheiden kann

Im Browser sendet Axios die Anfrage mit `XMLHttpRequest`. Laut MDN feuert dessen `error`-Ereignis, wenn die Anfrage auf einen Fehler trifft, und JavaScript kann nicht lesen, warum eine CORS-Anfrage fehlschlug. Feuert dieses Ereignis, lehnt Axios mit `Network Error` ab.

Die Axios-Doku sagt dasselbe. `ERR_NETWORK` umfasst Netzwerkprobleme und CORS, und der Browser gibt der Seite den Grund nicht, also schau in die Browser-Konsole.

axios/axios#383 bat im Juli 2016 um einen Code oder Status für `Network Error`. Heute ist `ERR_NETWORK` dieser Code, und er deckt alle 3 Ursachen ab.

1. Eine abgelehnte Verbindung, eine CORS-Sperre oder ein unbekannter Host
2. Das `error`-Ereignis von `XMLHttpRequest`, mit Status 0
3. `AxiosError: Network Error`

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

## Was LogBrew aufzeichnet

Jede Ablehnung kam beim SDK als unbehandelte Ablehnung an. LogBrew hat alle 5 in 1 Issue gesammelt, `Unhandled promise rejection: AxiosError`, mit dem Gruppierungsschlüssel `browser.unhandledrejection:AxiosError:/axios-lab.js`. Die Meldung war `redacted`, also sagt das Issue nicht, welche Anfrage fehlschlug.

Wir haben auch `installLogBrewBrowserXhrInstrumentation()` eingeschaltet, das du selbst installierst. Es legte für jede Anfrage 1 `browser.xhr`-Span mit Methode und Pfad an. Die 3 Netzwerkfehler hatten `statusCode` 0 und `errorType` `error`, der Timeout `timeout`, und der 500 seinen Status.

Das Issue behielt außerdem Breadcrumbs der Anfragen vor dem Fehler, mit Methode, Host, Port und Pfad. Ein falscher Host oder Port in einem Breadcrumb zeigt auf die Ursache, auch ohne Span.

|  | `statusCode` | `errorType` |
| --- | --- | --- |
| Auf dem Port lauscht nichts | `0` | `error` |
| Kein CORS-Header | `0` | `error` |
| Der Host hat keinen DNS-Eintrag | `0` | `error` |
| Keine Antwort vor dem Timeout | `0` | `timeout` |
| Der Server antwortete 500 | `500` | Nein |

## Häufige Fragen

### Was bedeutet AxiosError Network Error?

Axios bekam für die Anfrage keine HTTP-Antwort. In unserem Test gaben eine abgelehnte Verbindung, ein fehlender CORS-Header und ein unbekannter Host alle diese Meldung, mit dem Code `ERR_NETWORK`.

### Ist AxiosError Network Error ein CORS-Fehler?

Manchmal. Ein fehlender `Access-Control-Allow-Origin`-Header löst ihn aus, aber auch ein Server, der nicht läuft, und ein falscher Host. Die Browser-Konsole nennt die Ursache.

### Warum klappt die Anfrage in Node.js, aber nicht im Browser?

Node.js wendet kein CORS an. In unserem Test antwortete der Endpunkt ohne CORS-Header in Node.js mit 200 und schlug in beiden Browsern mit `Network Error` fehl.

### Wie bekomme ich den Statuscode aus einem AxiosError?

Lies `error.response?.status`. Ein `Network Error` hat keine Antwort, also auch keinen Status. Ein 500 gibt `ERR_BAD_RESPONSE`, und `error.response.status` ist 500.

### Was ist ERR_NETWORK in Axios?

`ERR_NETWORK` ist der `code` jedes `Network Error`. Ein Timeout hat einen anderen Code, `ECONNABORTED`, und bei einem Timeout von 1.000 ms die Meldung `timeout of 1000ms exceeded`.

## Finde die Anfrage hinter jedem Network Error

Das LogBrew-Browser-SDK behält jede Anfrage als Breadcrumb mit Host und Pfad und zeichnet jedes `XMLHttpRequest` als Span auf, wenn du das einschaltest. Starte mit dem großzügigen kostenlosen Plan, ohne Kreditkarte.

[Kostenlos starten](https://logbrew.co/de)

## Quellen

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

## Weitere Fehler beheben

- [Den Script error beheben, der Meldung, Datei und Zeile verbirgt](https://logbrew.co/de/errors/script-error)
- [Den Fehler Failed to fetch beheben und seine 3 Ursachen unterscheiden](https://logbrew.co/de/errors/failed-to-fetch)
- [java.lang.NullPointerException in Kotlin und Android aus der Meldung beheben](https://logbrew.co/de/errors/nullpointerexception)
- [Minified React error #418 und #185 beheben, mit der vollen Meldung und deiner Quellzeile](https://logbrew.co/de/errors/minified-react-error)
- [Cannot use import statement outside a module im Browser und in Node.js beheben](https://logbrew.co/de/errors/cannot-use-import-statement-outside-a-module)
- [HTTP-Fehler 499 beheben und herausfinden, wer nicht mehr gewartet hat](https://logbrew.co/de/errors/http-499)
- [Fehler, die wir reproduziert haben, und wie du jeden behebst](https://logbrew.co/de/errors)
