Seiten

Themen

Werkzeuge

↑↓navigieren↵öffnenescschließen
Kodierung & Sicherheit

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.

Schnellsuche
42 CodesJeder Eintrag nennt die Ursache, den nächsten Prüfbefehl und ob ein erneuter Versuch hilft.
  • 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/health
    • curl -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/items
    • echo '{"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/me
    • curl -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/42
    • curl -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.zip
    • curl -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-after
    • sleep 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/items
    • docker 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-after
    • docker 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/slow
    • psql "$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 100
    • kubectl 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 3000
    • ss -ltnp | grep 3000
    • docker 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/items
    • curl -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> 443
    • curl -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.com
    • nslookup 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 :3000
    • kill -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.

    • id
    • ls -ld /var/lib/app
    • PORT=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 Werkzeug
Mein 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.

Alle Linux-Guides