HTTP 500 Internal Server Error

Der Server ist ausgefallen und kann keine weiteren hilfreichen Informationen liefern. An der Anfrage selbst muss nichts fehlerhaft sein.

Definiert in RFC 9110 §15.6.1 — 500 Internal Server Error · MDN-Referenz

Wo Ihnen HTTP 500 in der Praxis begegnet

Eine unbehandelte Ausnahme, eine Null-Dereferenzierung, ein fehlgeschlagener Datenbankaufruf ohne Catch-Block – Code, der bedeutet, dass der Server auf etwas gestoßen ist, womit er nicht gerechnet hat.

Warum Sie ihn testen sollten

Gegen eine gesunde API praktisch nicht auf Abruf auszulösen – deshalb gehen Wiederholungs-, Fallback- und Fehlermeldepfade so oft ungetestet in Produktion.

Was Ihr Client bei einem 500 tun sollte

Bei einer idempotenten Anfrage ist ein einzelner Wiederholungsversuch vertretbar. Bei allen schreibenden Anfragen birgt das Wiederholen eines 500-Fehlers das Risiko, die Arbeit doppelt auszuführen, da ein 500-Fehler nicht angibt, ob die Operation vor dem Fehler abgeschlossen war. Senden Sie daher einen Idempotenzschlüssel, um den Wiederholungsversuch sicher zu gestalten, oder versuchen Sie es gar nicht erst.

500 und die Codes, mit denen er verwechselt wird

Endpunkte, die 500 zurückgeben

7 Endpunkte dieses Playgrounds antworten mit 500. Alle sind kostenlos, ohne Anmeldung und im Browser oder mit curl aufrufbar.

Fragen zu HTTP 500

Sollte der Stacktrace in einem 500-Fehlertext enthalten sein?
In Produktion nie. Sinnvoll ist eine Korrelations-ID, die der Aufrufer dem Support nennen kann.
Ist es sicher, einen 500er erneut zu versuchen?
Nur, wenn die Anfrage idempotent ist oder einen Idempotency-Key trägt. Sonst kann eine Wiederholung einen bereits abgeschlossenen Schreibvorgang verdoppeln.

Weitere Server-Fehlercodes

Alle HTTP-Statuscodes · Alle 55 Mock-REST-APIs · Einstiegsanleitung

Zuletzt aktualisiert