Status- und Exit-Codes
Durchsucht HTTP-Statuscodes, Exit-Codes von Docker und Kubernetes und Netzwerk-Errnos an einer Stelle. Jeder Eintrag nennt die Ursache, den sofort ausführbaren Prüfbefehl und ob ein erneuter Versuch hilft.
Läuft vollständig in Ihrem Browser – nichts, was Sie einfügen, wird hochgeladen.
- 200OKWiederholbarHTTP
Die Anfrage war erfolgreich und der Body enthält das Ergebnis. Ein 200 mit leerem Body kommt meist aus einem Cache oder einem Ausweigzweig.
curl -i https://example.com/api/healthcurl -sS https://example.com/api/health | head -c 200- Dieselbe Anfrage kann unverändert wiederholt werden.
- 201CreatedNicht wiederholenHTTP
Die Anfrage hat eine Ressource erzeugt. Der Location-Header zeigt auf den neuen Datensatz; fehlt er, kann der Client meist nicht weiterarbeiten.
curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/items- Dieselbe Anfrage liefert dieselbe Antwort.
- 204No ContentNicht wiederholenHTTP
Die Anfrage war erfolgreich und die Antwort hat keinen Body. Code, der immer JSON parst, scheitert hier an einem unerwarteten JSON-Ende.
curl -i -X DELETE https://example.com/api/items/42- Dieselbe Anfrage liefert dieselbe Antwort.
- 301Moved PermanentlyWiederholbarHTTP
Die URL hat sich dauerhaft geändert und Clients cachen die Weiterleitung. Nur nutzen, wenn der alte Pfad nicht zurückkommt; ein vorübergehender Umzug gehört auf 302 oder 307.
curl -sSIL https://example.com/old-path- Dieselbe Anfrage kann unverändert wiederholt werden.
- 302FoundWiederholbarHTTP
Eine vorübergehende Weiterleitung, bei der Clients POST zu GET machen können. Muss die API die Methode behalten, nimm 307 oder 308.
curl -sSIL https://example.com/login- Dieselbe Anfrage kann unverändert wiederholt werden.
- 304Not ModifiedWiederholbarHTTP
Die Kopie im Cache ist noch gültig, deshalb wird kein Body gesendet. Sie erscheint nur mit If-None-Match oder If-Modified-Since und ist im Log kein Fehler.
curl -i -H 'If-None-Match: "etag"' https://example.com/page- Dieselbe Anfrage kann unverändert wiederholt werden.
- 307Temporary RedirectWiederholbarHTTP
Vorübergehende Weiterleitung, die Methode und Body beibehält — genau das, was ein POST an eine andere URL braucht.
curl -sSIL -X POST https://example.com/api/old- Dieselbe Anfrage kann unverändert wiederholt werden.
- 308Permanent RedirectWiederholbarHTTP
Dauerhafte Weiterleitung, die Methode und Body beibehält. Browser cachen sie, ein falsches Ziel lässt sich kaum zurücknehmen.
curl -sSIL https://example.com/old- Dieselbe Anfrage kann unverändert wiederholt werden.
- 400Bad RequestNach Korrektur wiederholenHTTP
Der Server konnte die Anfrage nicht lesen: kaputtes JSON, fehlendes Pflichtfeld oder falscher Content-Type. Fast jedes Framework nennt im Body das betroffene Feld.
curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/itemsecho '{"name":"test"}' | python3 -m json.tool- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 401UnauthorizedNach Korrektur wiederholenHTTP
Die Anmeldung fehlt oder ist ungültig: kein Authorization-Header, abgelaufenes Token oder falsches Schema. Der WWW-Authenticate-Header zeigt, was der Server erwartet.
curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/mecurl -sSI https://example.com/api/me | grep -i www-authenticate- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 403ForbiddenNach Korrektur wiederholenHTTP
Die Anfrage ist angemeldet, aber nicht erlaubt. Prüfe Rolle oder Scope, Bucket- oder Tabellenrichtlinie und die IP-Allowlist; ein 403 nach dem Login ist ein Rechte-, kein Tokenproblem.
curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/admin- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 404Not FoundNicht wiederholenHTTP
Pfad oder Datensatz existiert nicht. Prüfe Route, abschließenden Schrägstrich, Basis-URL und ID; ein Proxy, der ein Pfadpräfix abschneidet, antwortet genauso.
curl -sSIL https://example.com/api/items/42curl -sS http://localhost:3000/api- Dieselbe Anfrage liefert dieselbe Antwort.
- 405Method Not AllowedNach Korrektur wiederholenHTTP
Die Route existiert, aber nicht für diese Methode: ein GET auf einen reinen POST-Endpunkt oder ein Proxy oder Formular, das die Methode umgeschrieben hat. Der Allow-Header nennt das Erlaubte.
curl -i -X GET https://example.com/api/items- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 408Request TimeoutWiederholbarHTTP
Der Client hat die Anfrage nicht rechtzeitig vollständig gesendet. Meist ein langsamer Upload über eine schwache Verbindung oder ein Proxy-Timeout unter dem Bedarf des Clients.
curl -sS -o /dev/null -w '%{time_total}s\n' https://example.com/api/upload- Dieselbe Anfrage kann unverändert wiederholt werden.
- 409ConflictNach Korrektur wiederholenHTTP
Die Anfrage kollidiert mit dem aktuellen Zustand: doppelter eindeutiger Schlüssel, zwei Schreiber auf einer Zeile oder eine abweichende Version bei optimistischem Sperren. Neu lesen und erneut versuchen lohnt sich.
curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"a@b.c"}' https://example.com/api/users- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 413Payload Too LargeNach Korrektur wiederholenHTTP
Der Body überschreitet eine Grenze des Servers oder des Vorschaltgeräts: client_max_body_size in nginx, das Serverless-Limit oder die Body-Grenze des Frameworks. Komprimiere oder teile den Upload.
du -h ./upload.zipcurl -i -F 'file=@upload.zip' https://example.com/api/upload- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 415Unsupported Media TypeNach Korrektur wiederholenHTTP
Der Content-Type ist nicht der, den der Endpunkt annimmt. Häufig wird ein JSON-Body als Formular gesendet; setze application/json und halte das JSON gültig.
curl -i -X POST -H 'Content-Type: application/json' -d '{"a":1}' https://example.com/api/items- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 422Unprocessable EntityNach Korrektur wiederholenHTTP
Das Format stimmt, aber die Werte scheitern an der Validierung. FastAPI, Rails und Laravel liefern die Feldfehler im Body, lies sie, bevor du die Anfrage umbaust.
curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"nope"}' https://example.com/api/users- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 429Too Many RequestsWiederholbarHTTP
Ein Raten- oder Kontingentlimit wurde erreicht. Lies Retry-After, warte mit Jitter und prüfe, welcher Schlüssel begrenzt ist: IP, API-Schlüssel oder angemeldeter Nutzer.
curl -sSI https://example.com/api/items | grep -i retry-aftersleep 5 && curl -i https://example.com/api/items- Dieselbe Anfrage kann unverändert wiederholt werden.
- 500Internal Server ErrorWiederholbarHTTP
Der Server hat einen unbehandelten Fehler geworfen. Der Stacktrace steht im Serverlog, und ein 500 nur auf einer Route zeigt auf diesen Handler, nicht aufs Netzwerk.
curl -i https://example.com/api/itemsdocker compose logs -f --tail 50 api- Dieselbe Anfrage kann unverändert wiederholt werden.
- 502Bad GatewayWiederholbarHTTP
Der Proxy hat das Upstream erreicht, aber keine brauchbare Antwort bekommen: Die App ist abgestürzt oder startet neu, hört auf einem anderen Port oder antwortet per HTTP auf einem TLS-Port.
curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' https://example.com/docker compose ps- Dieselbe Anfrage kann unverändert wiederholt werden.
- 503Service UnavailableWiederholbarHTTP
Der Server läuft, kann aber nicht bedienen: Überlast, Wartungsmodus, eine fehlschlagende Abhängigkeit oder keine gesunde Instanz hinter dem Loadbalancer. Retry-After sagt, wann es weitergeht.
curl -sSI https://example.com/ | grep -i retry-afterdocker compose ps- Dieselbe Anfrage kann unverändert wiederholt werden.
- 504Gateway TimeoutWiederholbarHTTP
Der Proxy hat länger als sein Timeout auf das Upstream gewartet. Schau auf langsame Abfragen, fehlende Indizes, proxy_read_timeout oder das Ausführungslimit der Funktion — vor dem Code.
curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' http://localhost:3000/api/slowpsql "$DATABASE_URL" -c 'EXPLAIN ANALYZE SELECT 1'- Dieselbe Anfrage kann unverändert wiederholt werden.
- 0Exit 0 — successWiederholbarContainer & Exit
Der Prozess ist erfolgreich beendet. Bei einem einmaligen Job richtig, bei einem Dienst, der laufen muss, ein Fehler: Prüfe, ob der Entrypoint seine Arbeit beendet und dann beendet.
docker logs --tail 50 <container>docker inspect --format '{{.State.ExitCode}}' <container>- Dieselbe Anfrage kann unverändert wiederholt werden.
- 1Exit 1 — application errorNach Korrektur wiederholenContainer & Exit
Die Anwendung selbst ist gescheitert: unbehandelte Ausnahme, fehlgeschlagene Prüfung, fehlende Migration. Der Grund steht in den letzten Zeilen des Container-Logs.
docker logs --tail 100 <container>docker inspect --format '{{.State.ExitCode}}' <container>- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 2Exit 2 — usage errorNach Korrektur wiederholenContainer & Exit
Shell-Builtin oder Kommandozeile war falsch: ungültige Option, fehlendes Argument oder eine unlesbare Datei im Entrypoint-Skript.
docker logs --tail 50 <container>docker run --rm -it --entrypoint sh <image>- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 126Exit 126 — cannot executeNach Korrektur wiederholenContainer & Exit
Der Befehl existiert, lässt sich aber nicht ausführen: fehlendes Ausführrecht, Windows-Zeilenenden im Shebang oder ein Interpreter, der nicht im Image ist.
docker run --rm -it --entrypoint sh <image> -c 'ls -l /entrypoint.sh'file /path/to/entrypoint.sh- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 127Exit 127 — command not foundNach Korrektur wiederholenContainer & Exit
Der Befehl wurde im PATH des Images nicht gefunden: Tippfehler, nie installiertes Paket oder ein Binary, das nur in einer anderen Stufe des Multi-Stage-Builds liegt.
docker run --rm -it --entrypoint sh <image> -c 'command -v node'docker run --rm -it --entrypoint sh <image> -c 'echo $PATH'- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 130Exit 130 — SIGINTWiederholbarContainer & Exit
Der Prozess wurde mit Ctrl-C gestoppt, 128 plus Signal 2. Bei einem selbst unterbrochenen Container normal; passiert es ohne jemanden am Terminal, ist etwas faul.
docker inspect --format '{{.State.ExitCode}}' <container>- Dieselbe Anfrage kann unverändert wiederholt werden.
- 137Exit 137 — SIGKILL / OOMKilledNach Korrektur wiederholenContainer & Exit
Der Container wurde mit 128 plus Signal 9 beendet. Meist hat der OOM-Killer zugeschlagen, also vergleiche die Speicherspitze der App mit ihrem Limit, bevor du es erhöhst.
docker inspect --format '{{.State.OOMKilled}}' <container>docker stats --no-stream <container>kubectl describe pod <pod> | grep -i -A2 'Last State'- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 139Exit 139 — SIGSEGVNach Korrektur wiederholenContainer & Exit
Der Prozess ist an einem Segmentation Fault gestorben, 128 plus Signal 11. Häufig bei einem nativen Modul für eine andere libc oder einer abweichenden Node- oder Python-ABI.
docker logs --tail 100 <container>docker inspect --format '{{.Config.Image}}' <container>- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- 143Exit 143 — SIGTERMWiederholbarContainer & Exit
Der Container hat SIGTERM erhalten, 128 plus Signal 15, also die normale Stoppanforderung. Tritt es von selbst wiederholt auf, beendet die App ihren Shutdown nicht in der Frist.
docker inspect --format '{{.Config.StopTimeout}}' <container>docker logs --tail 50 <container>- Dieselbe Anfrage kann unverändert wiederholt werden.
- CrashLoopBackOffKubernetes CrashLoopBackOffNach Korrektur wiederholenContainer & Exit
Kubernetes startet den Container neu, weil er immer wieder endet, und die Wartezeit zwischen Versuchen wächst. Die Ausgabe des vorigen Versuchs nennt den Grund.
kubectl logs <pod> --previous --tail 100kubectl describe pod <pod> | grep -i -A5 'Last State'- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- ImagePullBackOffKubernetes ImagePullBackOffNach Korrektur wiederholenContainer & Exit
Das Image lässt sich nicht ziehen: ein Tag, den es nicht gibt, eine private Registry ohne imagePullSecrets oder eine Registry, die den Node begrenzt.
kubectl describe pod <pod> | sed -n '/Events/,$p'kubectl get secret <secret> -o yaml- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- CreateContainerConfigErrorKubernetes CreateContainerConfigErrorNach Korrektur wiederholenContainer & Exit
Der Container lässt sich nicht erzeugen, weil etwas Referenziertes fehlt: ein Secret oder ConfigMap, einer seiner Schlüssel oder das Volume, das ihn trägt.
kubectl describe pod <pod> | sed -n '/Events/,$p'kubectl get secret,configmap- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- EvictedKubernetes EvictedNach Korrektur wiederholenContainer & Exit
Der Pod wurde verdrängt, weil dem Node Speicher, Plattenplatz oder Prozesse ausgingen. Unrealistische Requests und Limits und ein voller Node sind die üblichen Ursachen.
kubectl get pod <pod> -o jsonpath='{.status.reason}{"\\n"}{.status.message}{"\\n"}'kubectl describe node <node> | grep -i -A6 'Conditions'- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- ECONNREFUSEDECONNREFUSEDWiederholbarNetzwerk-Errno
Auf diesem Host und Port hört nichts, oder es hört nur auf 127.0.0.1. In Docker ist der Host der Dienstname, nicht localhost, und der Port der des Containers.
nc -vz localhost 3000ss -ltnp | grep 3000docker compose ps- Dieselbe Anfrage kann unverändert wiederholt werden.
- ECONNRESETECONNRESETWiederholbarNetzwerk-Errno
Die Gegenseite hat die Verbindung mitten in der Anfrage geschlossen: Der Peer ist abgestürzt oder hat ein Timeout erreicht, ein Proxy oder Loadbalancer hat eine idle Verbindung beendet, oder HTTP ging an einen TLS-Port.
curl -v https://example.com/api/itemscurl -v --http1.1 --keepalive-time 30 https://example.com/- Dieselbe Anfrage kann unverändert wiederholt werden.
- ETIMEDOUTETIMEDOUTWiederholbarNetzwerk-Errno
Rechtzeitig kam keine Antwort: Routing, Firewall oder Security Group, falscher Host oder ein zu langsamer Peer. Prüfe den Port, bevor du den Code änderst.
nc -vz -w 5 <host> 443curl -sS -o /dev/null -w '%{time_connect}s %{time_total}s\n' https://example.com/- Dieselbe Anfrage kann unverändert wiederholt werden.
- ENOTFOUNDENOTFOUNDNach Korrektur wiederholenNetzwerk-Errno
Der Hostname wurde nicht aufgelöst: Tippfehler, fehlende Suchdomain, ein Container ohne DNS oder ein Resolver mit Ratenlimit.
getent hosts api.example.comnslookup api.example.com 1.1.1.1- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- EADDRINUSEEADDRINUSENach Korrektur wiederholenNetzwerk-Errno
Der Port ist auf dieser Maschine schon belegt: ein anderer Prozess oder eine frühere Instanz, die nie beendet wurde.
lsof -i :3000kill -15 $(lsof -t -i :3000)- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
- EACCESEACCESNach Korrektur wiederholenNetzwerk-Errno
Zugriff verweigert: ein Port unter 1024 ohne Recht, oder eine Datei oder ein Verzeichnis, in das der Prozess nicht schreiben darf. Im Container meist ein Nicht-root-Nutzer mit root-eigenem Volume.
idls -ld /var/lib/appPORT=8080 node server.js- Erst nach dem Beheben der Ursache wiederholen; jetzt bringt es nichts.
Status- und Exit-Code-Referenz
Kurzreferenz- 4xx vs 5xx
- Ein 4xx heißt, dass die Anfrage des Clients zu korrigieren ist, ein 5xx ein Serverfehler; ein 502 oder 504 nur auf einer Route kommt fast immer vom Upstream hinter dem Proxy.
- 128 + signal
- Die Shell meldet einen durch ein Signal beendeten Prozess als 128 plus Signalnummer: 137 ist 128+9 (SIGKILL), 143 ist 128+15 (SIGTERM) und 139 ist 128+11 (SIGSEGV).
- OOMKilled
- Ein 137 mit OOMKilled true in docker inspect heißt, dass das Speicherlimit erreicht wurde; ein Limit unter der Spitze der App startet sie genauso neu.
- CrashLoopBackOff
- Kubernetes startet den Container neu, weil er immer wieder endet; kubectl logs --previous zeigt den fehlgeschlagenen Versuch.
- ECONNREFUSED
- Auf diesem Host und Port hört nichts; in Docker ist der Host der Dienstname und nicht localhost, und der Port ist der des Containers.
- Retry-After
- Diesen Header sendet ein 429 oder 503, um zu sagen, wann es weitergeht; warte mit Jitter statt in einer engen Schleife zu wiederholen.
Häufige Fragen
Antworten unter dem WerkzeugMein Container endete mit 137 – was heißt das?
137 ist 128 + 9, also SIGKILL: entweder der OOM-Killer oder docker stop. OOMKilled in docker inspect unterscheidet beide Fälle.
Was bedeutet CrashLoopBackOff?
Kubernetes startet den Container immer wieder, weil er beendet wird; kubectl logs --previous zeigt, warum der letzte Versuch starb.
Darf ich ein 503 wiederholen?
Ja, mit Backoff: Meist ist es ein vorübergehendes Upstream- oder Kapazitätsproblem, und Retry-After nennt die Wartezeit.
Passende Linux-Syntax-Guides
Alle Linux-GuidesLinux: Too many open files (EMFILE) and ulimit
EMFILE is a per-process descriptor limit, ENFILE is the kernel's. Read the limit from /proc, raise it in the right layer, and find the leak that made it matter.
Linuxsystemd status=203/EXEC and 217/USER: Exec and Permission Failures
203 is a failed execve, 217 is a user systemd could not resolve. Both happen before your program runs, and the check that finds each takes one command.
Linuxsystemd Timers vs Cron: Missing PATH, Overlapping Runs, Time Drift
Cron runs a bare shell with no profile and no locking, and systemd reads the system time zone. The environment, single-instance and schedule fixes for both.
LinuxBash Indexed Arrays, Associative Maps, and Parameter Expansion
Quoting decides whether an array stays a list, and the expansion operators replace most external text tools. Includes set -u, mapfile, namerefs, and the bash 3.2 differences that break scripts on macOS.