Weiße Seite in WordPress: Ursache finden und beheben
Du rufst deine Website auf, und statt der Startseite erscheint eine leere Fläche oder ein knapper Hinweis auf einen kritischen Fehler. Die wichtigste Nachricht steht gleich am Anfang: Deine Inhalte sind in aller Regel nicht verloren, sie liegen weiterhin in der Datenbank. WordPress kann die Seite im Moment nur nicht ausgeben.
Zusammenfassung
- Weiße Seite heißt Ausgabefehler, nicht Datenverlust
- Wiederherstellungsmodus und Administrations-Postfach zuerst prüfen
- Plug-ins über den Ordner
pluginsabschalten - Ordner danach wieder zurückbenennen
- Theme-Datei zurückspielen oder Theme-Ordner umbenennen
WP_DEBUGschreibt die Ursache ins Protokoll- Vor jeder Dateiänderung eine Sicherung anlegen
Was weiß heute wirklich heißt
Früher zeigte WordPress bei schweren Fehlern tatsächlich eine komplett leere Seite. Daher stammt die eingebürgerte Bezeichnung White Screen of Death. Heute ist das meist nicht mehr so. In vielen Fällen erscheint stattdessen ein Hinweis auf einen kritischen Fehler, oder WordPress greift auf den Wiederherstellungsmodus zurück.
Wer eine Fehlermeldung statt einer leeren Fläche sieht, liest trotzdem den richtigen Artikel. Es handelt sich um dasselbe Problem in einer neueren Darstellung. Als Ursache kommen ein Plug-in, das nicht funktioniert, ein Fehler im PHP-Code oder Probleme mit der Datenbank in Frage.
Dahinter steckt fast nie ein Verlust. Eine weiße Seite bedeutet, dass WordPress die Seite nicht ausgeben kann, nicht dass etwas gelöscht wurde. Deine Beiträge, Seiten und Einstellungen stehen weiterhin in der Datenbank, und sobald die Ursache behoben ist, erscheinen sie wieder.
Zeigt deine Website statt einer weißen Fläche einen HTTP-Fehler 500, ist das ein eigenes Thema mit eigenen Ursachen. Dieser Artikel bleibt bei der weißen Seite.
Die folgende Tabelle ordnet dem, was du siehst, den ersten sinnvollen Schritt zu.
| Anzeichen | Erster Schritt |
|---|---|
| Hinweis auf einen kritischen Fehler | Postfach der Administration prüfen |
| Leere Fläche, Dashboard erreichbar | Zuletzt geändertes Plug-in abschalten |
| Leere Fläche, Dashboard nicht erreichbar | Ordner plugins umbenennen |
| Meldung mit Datei und Zeilennummer | Betroffene Theme-Datei zurückspielen |
| Keiner dieser Fälle trifft zu | WP_DEBUG einschalten und Protokoll lesen |
Zuerst: die E-Mail prüfen
Ab Version 5.2 bringt WordPress den Wiederherstellungsmodus von Haus aus mit. Er springt bei einem kritischen Fehler von allein an. Auf der Website steht dann ein allgemein gehaltener Fehlerhinweis, und an die hinterlegte Adresse der Administration geht eine Nachricht raus.
In dieser Nachricht steckt ein Link, der genau einmal funktioniert. Damit kommst du trotz des Fehlers ins Backend. Dort zeigt WordPress an, welches Plug-in oder Theme den Fehler verursacht, und erlaubt es dir, die betroffene Erweiterung direkt abzuschalten. Das ist der mit Abstand schnellste Weg, und deshalb steht er vor allem anderen.
Ein Detail entscheidet hier oft über Erfolg oder Frust: Die Nachricht geht an die Adresse, die in den WordPress-Einstellungen als Administrator-Adresse hinterlegt ist. Das ist nicht zwingend die Adresse, die du gerade benutzt. Wirf außerdem einen Blick in den Spam-Ordner, dort landen solche automatischen Nachrichten gern.
Dieser Weg klappt allerdings nicht immer. Liegt der PHP-Fehler zu tief, kommt gar keine Nachricht an. Dann geht es mit den folgenden Schritten weiter.
Prüfe das Postfach trotzdem gründlich, bevor du zu FTP greifst. Der Wiederherstellungsmodus nennt dir die verantwortliche Erweiterung beim Namen und spart dir damit die gesamte Suche über Dateien und Ordner. Jede Minute, die du hier investierst, ist besser angelegt als zehn Minuten im Dateimanager.
Plug-ins als Ursache
Plug-ins sind der häufigste Auslöser einer weißen Seite. Typische Fälle: Du hast ein Plug-in neu aktiviert, die Einstellungen eines aktiven Plug-ins geändert oder den Code eines aktiven Plug-ins angepasst.
Ist dein Dashboard noch erreichbar, hast du es leicht. Schalte dort das zuletzt geänderte Plug-in ab und lade die Website neu. Damit ist das Problem oft schon erledigt.
Bleibt das Dashboard dunkel und kam auch keine E-Mail an, führt der Weg über FTP oder den Dateimanager deines Hostings. Lege zuerst eine Sicherung der betroffenen Dateien an, erst danach folgen diese Schritte:
- Öffne das Verzeichnis, in dem die WordPress-Dateien liegen.
- Öffne darin den Ordner
wp-content. - Darin liegt der Ordner
plugins. - Benenne diesen Ordner um. Damit sind alle Plug-ins auf einmal abgeschaltet.
Der umbenannte Ordner ist dabei nur ein Test, keine Lösung. WordPress findet das Verzeichnis unter dem alten Namen nicht mehr und lädt deshalb kein einziges Plug-in. Genau das willst du an dieser Stelle wissen.
Lädt die Website danach wieder, kennst du die Richtung: Eines deiner Plug-ins verursacht den Fehler. Jetzt kommt der Schritt, der in den meisten Anleitungen fehlt. Benenne den Ordner wieder auf plugins zurück. Deine Plug-ins sind danach abgeschaltet, und du schaltest sie einzeln wieder ein, bis der Verursacher auffällt. Wer den Ordner umbenannt lässt, betreibt eine laufende Website ganz ohne Plug-ins.
Theme als Ursache
Wenn kein Plug-in schuld ist, kommt eine geänderte PHP-Datei des Themes in Frage, besonders functions.php. Das betrifft vor allem Websites, an denen zuletzt jemand über den Theme-Editor von WordPress gearbeitet hat.
In solchen Fällen zeigt WordPress oft eine konkrete Fehlermeldung oder geht in den Wiederherstellungsmodus. Eine typische Meldung nennt Datei und Zeilennummer. Sie bedeutet: An dieser Stelle steht ein Fehler im Code, und das Theme lässt sich deshalb nicht ausgeben.
Die Lösung besteht darin, den ursprünglichen Zustand der Datei wiederherzustellen. Du spielst also eine funktionierende Fassung ein, entweder aus einer Sicherung oder aus der Originalfassung des Themes. Über FTP oder den Dateimanager gehst du so vor:
- Öffne das Verzeichnis mit den WordPress-Dateien.
- Öffne den Ordner
wp-content. - Öffne darin den Themes-Ordner.
- Öffne den Ordner des aktiven Themes.
- Ersetze dort die betroffene Datei.
Die Zeilennummer aus der Meldung hilft dir dabei, die richtige Datei zu erwischen. Was im Code inhaltlich falsch ist, verrät die Meldung dir nicht, doch welche Datei du ersetzen musst, steht darin. Mehr brauchst du für diesen Schritt nicht.
Es gibt eine Alternative, wenn du keine funktionierende Fassung zur Hand hast: Benenne den Ordner des Themes um. Findet WordPress das aktive Theme nicht mehr, nimmt es von allein eines der mitgelieferten Standard-Themes. Dein Backend ist damit wieder erreichbar und die Website läuft, nur eben mit einem anderen Aussehen.
Wenn die Ursache unklar bleibt
Manchmal hat niemand ein Plug-in angefasst und auch am Theme nichts geändert. Dann hilft systematisches Vorgehen statt Raten. Das Mittel dafür heißt WP_DEBUG, eine eingebaute Protokollfunktion von WordPress.
Öffne dafür wp-config.php. Die Datei liegt ganz oben in deiner WordPress-Installation. Dort kommen diese drei Zeilen hinein:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);phpDie zweite Zeile sorgt dafür, dass jede Meldung in einer Protokolldatei unter wp-content/debug.log landet, statt irgendwo sichtbar zu werden. Diese Datei liest du anschließend über FTP oder den Dateimanager. Dort steht in der Regel, welche Datei und welche Zeile den Fehler auslösen.
WP_DEBUG_DISPLAY bleibt auf false. Sonst erscheinen die Fehlermeldungen öffentlich auf deiner Website, und Debug-Ausgaben können Pfade zur Datenbank oder Angaben zur Serverkonfiguration enthalten. Auf einer Live-Website ist das ein Sicherheitsproblem. Setze nach der Fehlersuche alle drei Einträge wieder auf false, der Debug-Modus bleibt nicht dauerhaft an.
Daneben gibt es Ursachen, die nicht sofort ins Auge fallen. Steckt ein Caching-Plug-in dahinter, genügt oft schon ein geleerter Cache der Seite. Geht das nicht, weil WordPress nicht erreichbar ist, leere stattdessen den Zwischenspeicher deines Browsers.
Auch beschädigte WordPress-Dateien kommen vor. In diesem Fall ist der Support deines Hostings die richtige Stelle, denn dort lässt sich prüfen, was auf dem Server tatsächlich liegt. Schließlich endet auch eine Überlastung oder ein kurzer Ausfall beim Hoster mitunter in einer weißen Seite. Schau ins Postfach, ob von dort eine Mitteilung gekommen ist.
Bevor du Dateien anfasst
Alle Wege über FTP oder den Dateimanager haben eines gemeinsam: Du veränderst echte Dateien deiner Website. Drei Gewohnheiten halten dieses Vorgehen harmlos.
Lege vor jeder Änderung per FTP oder Dateimanager eine Sicherung der betroffenen Dateien an. Das ist der Punkt, an dem aus einem reinen Anzeigefehler ein echter Verlust werden kann.
Ändere außerdem immer nur eine Sache auf einmal und prüfe danach, ob die Seite wieder lädt. Wer mehreres gleichzeitig ändert, weiß am Ende nicht, was geholfen hat. Notiere zuletzt jeden Schritt, den du gegangen bist. So lässt sich jede Änderung wieder zurücknehmen, auch Tage später.
Die weiße Seite wirkt im ersten Moment dramatisch, ist aber ein Anzeigeproblem mit einer überschaubaren Zahl von Ursachen. Prüfe das Postfach der Administration, schalte Plug-ins ab, nimm dir das Theme vor und lass im Zweifel WP_DEBUG die Arbeit machen. Mit einer Sicherung im Rücken und einer Änderung nach der anderen kommst du dabei ruhig ans Ziel.