Du rufst deine Website auf, und statt der Start­sei­te erscheint eine leere Fläche oder ein knapper Hinweis auf einen kri­ti­schen Fehler. Die wich­tigs­te 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.

Zu­sam­men­fas­sung

  • Weiße Seite heißt Aus­ga­be­feh­ler, nicht Da­ten­ver­lust
  • Wie­der­her­stel­lungs­mo­dus und Ad­mi­nis­tra­ti­ons-Postfach zuerst prüfen
  • Plug-ins über den Ordner plugins ab­schal­ten
  • Ordner danach wieder zu­rück­be­nen­nen
  • Theme-Datei zu­rück­spie­len oder Theme-Ordner um­be­nen­nen
  • WP_DEBUG schreibt die Ursache ins Protokoll
  • Vor jeder Da­tei­än­de­rung eine Sicherung anlegen

Was weiß heute wirklich heißt

Früher zeigte WordPress bei schweren Fehlern tat­säch­lich eine komplett leere Seite. Daher stammt die ein­ge­bür­ger­te Be­zeich­nung White Screen of Death. Heute ist das meist nicht mehr so. In vielen Fällen erscheint statt­des­sen ein Hinweis auf einen kri­ti­schen Fehler, oder WordPress greift auf den Wie­der­her­stel­lungs­mo­dus zurück.

Wer eine Feh­ler­mel­dung statt einer leeren Fläche sieht, liest trotzdem den richtigen Artikel. Es handelt sich um dasselbe Problem in einer neueren Dar­stel­lung. Als Ursache kommen ein Plug-in, das nicht funk­tio­niert, 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 Ein­stel­lun­gen stehen weiterhin in der Datenbank, und sobald die Ursache behoben ist, er­schei­nen 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 sinn­vol­len Schritt zu.

Anzeichen Erster Schritt
Hinweis auf einen kri­ti­schen Fehler Postfach der Ad­mi­nis­tra­ti­on prüfen
Leere Fläche, Dashboard er­reich­bar Zuletzt ge­än­der­tes Plug-in ab­schal­ten
Leere Fläche, Dashboard nicht er­reich­bar Ordner plugins um­be­nen­nen
Meldung mit Datei und Zei­len­num­mer Be­trof­fe­ne Theme-Datei zu­rück­spie­len
Keiner dieser Fälle trifft zu WP_DEBUG ein­schal­ten und Protokoll lesen

Zuerst: die E-Mail prüfen

Ab Version 5.2 bringt WordPress den Wie­der­her­stel­lungs­mo­dus von Haus aus mit. Er springt bei einem kri­ti­schen Fehler von allein an. Auf der Website steht dann ein allgemein ge­hal­te­ner Feh­ler­hin­weis, und an die hin­ter­leg­te Adresse der Ad­mi­nis­tra­ti­on geht eine Nachricht raus.

In dieser Nachricht steckt ein Link, der genau einmal funk­tio­niert. Damit kommst du trotz des Fehlers ins Backend. Dort zeigt WordPress an, welches Plug-in oder Theme den Fehler ver­ur­sacht, und erlaubt es dir, die be­trof­fe­ne Er­wei­te­rung direkt ab­zu­schal­ten. Das ist der mit Abstand schnells­te Weg, und deshalb steht er vor allem anderen.

Ein Detail ent­schei­det hier oft über Erfolg oder Frust: Die Nachricht geht an die Adresse, die in den WordPress-Ein­stel­lun­gen als Ad­mi­nis­tra­tor-Adresse hin­ter­legt ist. Das ist nicht zwingend die Adresse, die du gerade benutzt. Wirf außerdem einen Blick in den Spam-Ordner, dort landen solche au­to­ma­ti­schen Nach­rich­ten gern.

Dieser Weg klappt al­ler­dings 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 Wie­der­her­stel­lungs­mo­dus nennt dir die ver­ant­wort­li­che Er­wei­te­rung beim Namen und spart dir damit die gesamte Suche über Dateien und Ordner. Jede Minute, die du hier in­ves­tierst, ist besser angelegt als zehn Minuten im Da­tei­ma­na­ger.

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 Ein­stel­lun­gen eines aktiven Plug-ins geändert oder den Code eines aktiven Plug-ins angepasst.

Ist dein Dashboard noch er­reich­bar, 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 Da­tei­ma­na­ger deines Hostings. Lege zuerst eine Sicherung der be­trof­fe­nen Dateien an, erst danach folgen diese Schritte:

  1. Öffne das Ver­zeich­nis, in dem die WordPress-Dateien liegen.
  2. Öffne darin den Ordner wp-content.
  3. Darin liegt der Ordner plugins.
  4. Benenne diesen Ordner um. Damit sind alle Plug-ins auf einmal ab­ge­schal­tet.

Der um­be­nann­te Ordner ist dabei nur ein Test, keine Lösung. WordPress findet das Ver­zeich­nis 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 ver­ur­sacht den Fehler. Jetzt kommt der Schritt, der in den meisten An­lei­tun­gen fehlt. Benenne den Ordner wieder auf plugins zurück. Deine Plug-ins sind danach ab­ge­schal­tet, und du schaltest sie einzeln wieder ein, bis der Ver­ur­sa­cher 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 ge­ar­bei­tet hat.

In solchen Fällen zeigt WordPress oft eine konkrete Feh­ler­mel­dung oder geht in den Wie­der­her­stel­lungs­mo­dus. Eine typische Meldung nennt Datei und Zei­len­num­mer. 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 ur­sprüng­li­chen Zustand der Datei wie­der­her­zu­stel­len. Du spielst also eine funk­tio­nie­ren­de Fassung ein, entweder aus einer Sicherung oder aus der Ori­gi­nal­fas­sung des Themes. Über FTP oder den Da­tei­ma­na­ger gehst du so vor:

  1. Öffne das Ver­zeich­nis mit den WordPress-Dateien.
  2. Öffne den Ordner wp-content.
  3. Öffne darin den Themes-Ordner.
  4. Öffne den Ordner des aktiven Themes.
  5. Ersetze dort die be­trof­fe­ne Datei.

Die Zei­len­num­mer aus der Meldung hilft dir dabei, die richtige Datei zu erwischen. Was im Code in­halt­lich 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 Al­ter­na­ti­ve, wenn du keine funk­tio­nie­ren­de Fassung zur Hand hast: Benenne den Ordner des Themes um. Findet WordPress das aktive Theme nicht mehr, nimmt es von allein eines der mit­ge­lie­fer­ten Standard-Themes. Dein Backend ist damit wieder er­reich­bar 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 sys­te­ma­ti­sches Vorgehen statt Raten. Das Mittel dafür heißt WP_DEBUG, eine ein­ge­bau­te Pro­to­koll­funk­ti­on von WordPress.

Öffne dafür wp-config.php. Die Datei liegt ganz oben in deiner WordPress-In­stal­la­ti­on. Dort kommen diese drei Zeilen hinein:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
php

Die zweite Zeile sorgt dafür, dass jede Meldung in einer Pro­to­koll­da­tei unter wp-content/debug.log landet, statt irgendwo sichtbar zu werden. Diese Datei liest du an­schlie­ßend über FTP oder den Da­tei­ma­na­ger. Dort steht in der Regel, welche Datei und welche Zeile den Fehler auslösen.

Hinweis

WP_DEBUG_DISPLAY bleibt auf false. Sonst er­schei­nen die Feh­ler­mel­dun­gen öf­fent­lich auf deiner Website, und Debug-Ausgaben können Pfade zur Datenbank oder Angaben zur Ser­ver­kon­fi­gu­ra­ti­on enthalten. Auf einer Live-Website ist das ein Si­cher­heits­pro­blem. Setze nach der Feh­ler­su­che 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 er­reich­bar ist, leere statt­des­sen den Zwi­schen­spei­cher deines Browsers.

Auch be­schä­dig­te 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 tat­säch­lich liegt. Schließ­lich endet auch eine Über­las­tung oder ein kurzer Ausfall beim Hoster mitunter in einer weißen Seite. Schau ins Postfach, ob von dort eine Mit­tei­lung gekommen ist.

Bevor du Dateien anfasst

Alle Wege über FTP oder den Da­tei­ma­na­ger haben eines gemeinsam: Du ver­än­derst echte Dateien deiner Website. Drei Ge­wohn­hei­ten halten dieses Vorgehen harmlos.

Hinweis

Lege vor jeder Änderung per FTP oder Da­tei­ma­na­ger eine Sicherung der be­trof­fe­nen Dateien an. Das ist der Punkt, an dem aus einem reinen An­zei­ge­feh­ler 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 gleich­zei­tig ändert, weiß am Ende nicht, was geholfen hat. Notiere zuletzt jeden Schritt, den du gegangen bist. So lässt sich jede Änderung wieder zu­rück­neh­men, auch Tage später.

Die weiße Seite wirkt im ersten Moment dra­ma­tisch, ist aber ein An­zei­ge­pro­blem mit einer über­schau­ba­ren Zahl von Ursachen. Prüfe das Postfach der Ad­mi­nis­tra­ti­on, 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.

Zum Hauptmenü