Lorixen.
DE

Fehlerseite bei Serverfehlern: 500 und 503 freundlich zeigen

Kurz gesagt: Wenn auf Ihrer Website etwas schiefgeht, etwa die Datenbank nicht antwortet oder ein Plugin abstürzt, sehen Besucher oft eine nackte Meldung wie „500 Internal Server Error“, eine weiße Seite oder die Standardseite des Webservers. Das wirkt, als sei der Betrieb verschwunden. Eine eigene Fehlerseite für Serverfehler erklärt in einem Satz, was los ist, bietet einen Ausweg wie Telefonnummer oder E-Mail und behält trotzdem den richtigen Statuscode. In nginx lässt sich das laut Dokumentation mit error_page einrichten, etwa für 500, 502, 503 und 504. Wichtig ist, dass die Fehlerseite selbst keine Datenbank und kein CMS braucht, damit sie auch dann funktioniert, wenn genau diese ausgefallen sind.

Was Besucher bei einem Serverfehler sehen

Ohne eigene Fehlerseite hängt die Anzeige davon ab, wo der Fehler entsteht:

  • Der Webserver zeigt seine Standardseite mit Fehlercode und Servername.
  • Das CMS zeigt eine technische Meldung, manchmal mit Pfaden oder Fehlerdetails.
  • Der Browser zeigt eine leere weiße Seite.
  • Ein vorgeschaltetes CDN zeigt seine eigene Fehlerseite mit fremdem Logo.

Für Kunden bedeuten alle Varianten dasselbe: Sie wissen nicht, ob es am eigenen Gerät liegt, ob der Betrieb noch existiert oder wie sie ihr Anliegen loswerden. Bei Shops und Buchungssystemen kostet das direkt Umsatz.

Was eine gute Fehlerseite für Serverfehler enthält

Eine hilfreiche Fehlerseite ist kurz und ruhig:

  • Ihr Logo und Ihre Farben, damit klar ist, dass die Besucher richtig sind.
  • Ein Satz zur Lage, etwa „Gerade gibt es ein technisches Problem. Wir arbeiten daran.“
  • Ein Ausweg: Telefonnummer, E-Mail-Adresse oder ein Hinweis auf einen anderen Kanal.
  • Eine Bitte, es in ein paar Minuten erneut zu versuchen, gern mit einem Knopf zum Neuladen.
  • Keine technischen Details: keine Fehlertexte, keine Pfade, keine Versionsnummern.

Formulieren Sie die Seite so, dass sie für jede Art von Serverfehler passt. Sie wissen beim Erstellen nicht, welcher Fehler sie später auslöst. Wer ein Formular abgeschickt hat und dann die Fehlerseite sieht, fragt sich vor allem, ob die Anfrage angekommen ist. Ein Satz wie „Falls Sie gerade etwas abgeschickt haben, melden Sie sich bitte kurz telefonisch“ nimmt diese Unsicherheit.

Den richtigen Statuscode behalten

Eine Fehlerseite muss mit einem Fehlercode ausgeliefert werden, nicht mit 200. Laut Google-Dokumentation zu Serverfehlern reduziert Google bei Antworten mit 5xx-Status die Crawl-Rate und erhöht sie wieder, sobald der Server normal antwortet. Adressen, die dauerhaft einen Serverfehler liefern, werden laut Google aus dem Index entfernt. Kurze Ausfälle schaden also wenig, solange der Code stimmt.

Liefert die Fehlerseite dagegen 200, hält die Suchmaschine sie für den echten Inhalt. Im schlimmsten Fall erscheint „Gerade gibt es ein technisches Problem“ als Text in den Suchergebnissen.

Einrichtung in nginx

Laut nginx-Dokumentation legt error_page fest, welche Adresse bei bestimmten Fehlern gezeigt wird. Das Beispiel aus der Dokumentation:

error_page 500 502 503 504 /50x.html;

nginx leitet dann intern auf diese Adresse um. Der Statuscode bleibt erhalten, sofern Sie ihn nicht ausdrücklich ändern. Die Datei 50x.html sollte eine statische HTML-Datei sein, mit eingebetteten Stilen und einem Logo, das als einfache Bilddatei oder direkt im HTML liegt.

Läuft Ihre Anwendung hinter nginx, etwa PHP oder Node.js, liefert sie bei einem Absturz manchmal selbst eine Fehlerseite aus. Prüfen Sie, ob in diesem Fall Ihre eigene Seite erscheint oder die der Anwendung. Viele Konfigurationen brauchen dafür eine zusätzliche Einstellung, damit nginx Fehler der Anwendung abfängt.

Bei Apache übernimmt die Anweisung ErrorDocument dieselbe Aufgabe. Bei Hostern mit Verwaltungsoberfläche lässt sich die Fehlerseite oft dort hochladen.

Unabhängig vom System bauen

Die häufigste Schwäche eigener Fehlerseiten: Sie werden im CMS als normale Seite angelegt. Fällt dann die Datenbank aus, kann das CMS auch die Fehlerseite nicht anzeigen. Sorgen Sie deshalb dafür, dass die Seite:

  • als statische Datei direkt vom Webserver kommt,
  • keine Skripte, Schriften oder Bilder von anderen Servern lädt,
  • ihre Stile im Dokument selbst enthält,
  • auch dann funktioniert, wenn Ihr CDN oder Ihre Schriftenquelle nicht erreichbar ist.

So bleibt sie auch im ungünstigsten Moment sichtbar.

Geplante Wartung ist ein eigener Fall

Für angekündigte Wartungsarbeiten ist 503 der passende Code. Laut MDN steht 503 für vorübergehende Zustände, und der Header Retry-After sollte nach Möglichkeit die erwartete Zeit bis zur Wiederherstellung enthalten. MDN empfiehlt außerdem eine nutzerfreundliche Seite, die das Problem erklärt, und weist darauf hin, dass Caching-Header bei 503 besondere Aufmerksamkeit brauchen, damit die Meldung nicht zwischengespeichert wird. Für Wartung lohnt eine eigene Seite mit Zeitangabe, getrennt von der allgemeinen Fehlerseite.

Fehler sichtbar machen

Eine schöne Fehlerseite darf nicht dazu führen, dass Ausfälle unbemerkt bleiben. Richten Sie eine einfache Überwachung ein, die Ihre Startseite und eine wichtige Unterseite regelmäßig abruft und Sie bei Fehlercodes benachrichtigt. Werten Sie außerdem das Fehlerprotokoll des Webservers aus. Häufen sich 500er auf einer bestimmten Seite, steckt dort meist ein konkreter Fehler.

So testen Sie die Fehlerseite

  1. Rufen Sie die Fehlerseite direkt auf und prüfen Sie Darstellung am Handy und am Rechner.
  2. Lösen Sie in einer Testumgebung einen Serverfehler aus, etwa durch eine absichtlich nicht erreichbare Datenbank.
  3. Prüfen Sie im Netzwerk-Tab, ob der Statuscode ein 5xx ist und nicht 200.
  4. Kontrollieren Sie, ob Telefonnummer und E-Mail-Adresse stimmen und anklickbar sind.
  5. Testen Sie, ob die Seite ohne Internetzugang zu externen Quellen vollständig erscheint.

Beispiel aus der Praxis

Ein Hotel in Bad Ischl nutzt ein Buchungssystem auf eigenem Server. Bei einer Überlastung der Datenbank sahen Gäste minutenlang die Standardseite des Webservers mit „502 Bad Gateway“. Mehrere schrieben später, sie hätten gedacht, das Hotel habe geschlossen. Heute erscheint in solchen Fällen eine schlichte Seite im Hoteldesign mit Telefonnummer und der Bitte, es kurz darauf erneut zu versuchen, ausgeliefert mit dem korrekten Fehlercode. Das Beispiel ist illustrativ.

Häufige Fragen

Schadet eine Fehlerseite der Suchmaschinenoptimierung?

Nicht, wenn sie mit dem richtigen 5xx-Code ausgeliefert wird. Laut Google senkt das bei kurzen Ausfällen nur vorübergehend die Crawl-Rate.

Kann ich die Fehlerseite im CMS gestalten?

Gestalten ja, ausliefern besser nicht. Exportieren Sie sie als statische Datei, damit sie auch funktioniert, wenn das CMS ausfällt.

Brauche ich für jeden Fehlercode eine eigene Seite?

Für Serverfehler reicht meist eine gemeinsame Seite. Für Wartung mit 503 und für 404 lohnen eigene Seiten.

Soll die Fehlerseite den Fehler genauer erklären?

Nein. Technische Details gehören ins Protokoll, nicht auf die Seite. Kunden brauchen einen Ausweg, keine Fehlermeldung.

Wenn Ihre Besucher bei Serverfehlern eine technische Meldung sehen, richten wir gerne eine eigene Fehlerseite mit Ihnen ein: Fehlerseite einrichten lassen.

Quellen

WhatsAppTermin buchen