HTTP-Statuscodes verstehen: Der vollständige Leitfaden

Jedes Mal, wenn Ihr Browser mit einem Webserver kommuniziert, gibt der Server einen HTTP-Statuscode zurück. Diese dreistelligen Zahlen teilen Ihrem Browser mit, ob die Anfrage erfolgreich war, weitergeleitet wurde oder auf einen Fehler gestoßen ist. Das Verständnis dieser Statuscodes ist für Webentwickler, SEO-Experten und jeden, der Websites verwaltet, von entscheidender Bedeutung.

Wie HTTP-Statuscodes organisiert sind

HTTP-Statuscodes werden nach ihrer ersten Ziffer in fünf Kategorien eingeteilt. Jede Kategorie repräsentiert eine Antwortklasse und hilft Ihnen, die Art der Serverantwort schnell zu identifizieren.

1xx – Informationsantworten

Diese Statuscodes zeigen an, dass der Server die Anfrage erhalten hat und mit der Verarbeitung fortfährt. Sie sind im alltäglichen Browsen selten zu sehen, aber wichtig für die Protokollaushandlung.

• 100 Continue: Der Server hat die Anfrage-Header erhalten, und der Client sollte mit dem Senden des Anfrage-Bodys fortfahren.
• 101 Switching Protocols: Der Server wechselt das Protokoll gemäß der Anfrage des Clients über den Upgrade-Header.
• 103 Early Hints: Wird verwendet, um Ressourcen vorzuladen, bevor die endgültige Antwort bereit ist, und verbessert so die Seitenladeleistung.

2xx – Erfolgreiche Antworten

Diese Statuscodes bestätigen, dass die Anfrage empfangen, verstanden und erfolgreich verarbeitet wurde.

• 200 OK: Die standardmäßige Erfolgsantwort. Die angeforderte Ressource wurde gefunden und zurückgegeben.
• 201 Created: Eine neue Ressource wurde erfolgreich erstellt, normalerweise als Antwort auf eine POST-Anfrage.
• 204 No Content: Die Anfrage war erfolgreich, aber es wird kein Inhalt zurückgegeben. Häufig bei DELETE-Anfragen.
• 206 Partial Content: Der Server liefert nur einen Teil der Ressource aus, verwendet für große Dateidownloads und Video-Streaming.

3xx – Weiterleitungen

Weiterleitungs-Statuscodes teilen dem Client mit, dass die angeforderte Ressource an einem anderen Ort verfügbar ist. Diese sind für SEO von entscheidender Bedeutung, da sie beeinflussen, wie Suchmaschinen Ihre Seiten indexieren.

• 301 Moved Permanently: Die Ressource wurde dauerhaft auf eine neue URL verschoben. Suchmaschinen übertragen die Link-Power auf die neue URL. Dies ist die wichtigste Weiterleitung für SEO.
• 302 Found: Die Ressource befindet sich vorübergehend unter einer anderen URL. Suchmaschinen behalten normalerweise den Index der ursprünglichen URL bei. Nur für temporäre Umzüge verwenden.
• 304 Not Modified: Zeigt an, dass die zwischengespeicherte Version der Ressource noch gültig ist. Dies spart Bandbreite, indem unnötige Datenübertragungen vermieden werden.
• 307 Temporary Redirect: Ähnlich wie 302, garantiert aber, dass die HTTP-Methode nicht geändert wird. Für technische Implementierungen zuverlässiger als 302.
• 308 Permanent Redirect: Ähnlich wie 301, garantiert aber, dass die HTTP-Methode nicht geändert wird. Die moderne Alternative zur permanenten 301-Weiterleitung.

4xx – Client-Fehler

Diese Statuscodes zeigen an, dass der Client einen Fehler in der Anfrage gemacht hat. Sie sind die Fehler, auf die Website-Besucher am häufigsten stoßen.

• 400 Bad Request: Der Server kann die Anfrage aufgrund eines Syntaxfehlers nicht verarbeiten. Überprüfen Sie Ihre Anfrageparameter und Header.
• 401 Unauthorized: Authentifizierung ist erforderlich und wurde nicht bereitgestellt oder ist fehlgeschlagen. Der Benutzer muss sich anmelden.
• 403 Forbidden: Der Server versteht die Anfrage, verweigert aber die Autorisierung. Anders als bei 401 hilft eine Authentifizierung auch nicht weiter.
• 404 Not Found: Die angeforderte Ressource existiert nicht auf dem Server. Dies ist der häufigste Fehlercode und kann erhebliche SEO-Auswirkungen haben, wenn er nicht richtig behandelt wird.
• 405 Method Not Allowed: Die Anfragemethode (GET, POST, PUT usw.) wird von der angeforderten Ressource nicht unterstützt.
• 429 Too Many Requests: Der Benutzer hat in einem bestimmten Zeitraum zu viele Anfragen gesendet. Dies ist eine Ratenbegrenzung, die häufig bei APIs verwendet wird.

5xx – Server-Fehler

Diese Statuscodes zeigen an, dass der Server eine gültige Anfrage nicht abschließen konnte. Sie repräsentieren serverseitige Probleme, die sofortige Aufmerksamkeit erfordern.

• 500 Internal Server Error: Eine generische Fehlermeldung, wenn der Server auf eine unerwartete Situation stößt. Überprüfen Sie die Serverprotokolle, um die Ursache zu finden.
• 502 Bad Gateway: Der Server fungiert als Gateway und hat eine ungültige Antwort vom Upstream-Server erhalten. Häufig bei Reverse-Proxys und CDNs.
• 503 Service Unavailable: Der Server kann die Anfrage vorübergehend nicht verarbeiten, normalerweise aufgrund von Wartung oder Überlastung. Verwenden Sie den Retry-After-Header, um anzugeben, wann ein erneuter Versuch möglich ist.
• 504 Gateway Timeout: Der Server fungiert als Gateway und hat keine rechtzeitige Antwort vom Upstream-Server erhalten.

Wie man HTTP-Statuscodes debuggt

Befolgen Sie bei der Fehlerbehebung von HTTP-Fehlern diesen systematischen Ansatz:

1. Statuscode prüfen: Bestimmen Sie, ob es sich um einen Client-Fehler (4xx) oder einen Server-Fehler (5xx) handelt.
2. Serverprotokolle einsehen: Bei 5xx-Fehlern enthalten die Serverprotokolle Stack-Traces und Fehlerdetails.
3. Anfrage-Header prüfen: Verwenden Sie die Browser-Entwicklertools, um zu überprüfen, ob die Anfrage korrekte Header, Cookies und Authentifizierungstoken enthält.
4. Mit curl testen: Reproduzieren Sie die Anfrage mit curl, um zu isolieren, ob das Problem client- oder serverseitig liegt.
5. Aktuelle Änderungen prüfen: Deployments, Konfigurationsaktualisierungen oder DNS-Änderungen verursachen häufig Statuscode-Fehler.