Nichts ist schlimmer, als auf Deiner WordPress-Seite zu surfen und plötzlich auf den weißen Bildschirm des Todes zu stoßen, was ihn sowohl für Administratoren als auch für Besucher unzugänglich macht. Heute werden wir Dich durch sechs allgemeine Probleme führen, die mit dem weißen WordPress-Todesbildschirm auftreten, und die häufigsten Ursachen und vor allem die Lösungen dafür präsentieren, damit Du Deine Website so schnell wie möglich wieder in Betrieb nehmen kannst.

WordPress white screen of death? 😱 Kein Grund zur Panik, so behebst du den Fehler schnell. Click to Tweet

WordPress White Screen of Death

Ein WordPress White Screen of Death (WSOD) wird fast immer durch PHP-Codefehler oder Speicherlimitauslastung verursacht. Das erste, was Du tun solltest, ist festzustellen, ob der Administrator auf Deiner Website funktioniert oder nicht. Wenn das Frontend der Website ausgefallen ist, aber der Admin funktioniert, besteht die Möglichkeit, dass Du ein fehlerhaftes Design oder Plugin hast. Du kannst Deinen Admin überprüfen, indem Du einfach zu yourdomain.com/wp-admin gehst.

Ein White Screen of Death kann je nach Browser auch etwas anders aussehen. Hier ist ein Beispiel für Google Chrome. Wir bekommen hier tatsächlich eine Warnung angezeigt: „Diese Seite funktioniert nicht und kann die Anfrage nicht bearbeiten.“ Dies ist ein HTTP 500-Fehler.

wordpress white screen of death chrome

WordPress white screen of death in Google Chrome

In Mozilla Firefox ist es nur ein komplett weißer Bildschirm ohne Fehler oder Warnungen.

wordpress white screen of death firefox

WordPress white screen of death in Mozilla Firefox

Wie man einen WSOD repariert

Wenn Du einen Bildschirm wie oben siehst, sind hier einige allgemeine Schritte, um das Problem zu lösen:

  1. Plugins und Designs deaktivieren
  2. Syntaxfehler beheben
  3. Debugging einschalten
  4. Erhöhung der Speicherbegrenzung
  5. Dateiberechtigungsprobleme prüfen
  6. Nach fehlgeschlagenem Auto-Update suchen

1. Plugins und Designs deaktivieren

Eine der einfachsten und häufigsten Möglichkeiten, den weißen WordPress-Todesbildschirm zu reparieren, ist die einfache Deaktivierung aller Deiner Plugins. Oftmals stürzt eine Website aufgrund eines schlechten Plugin-Updates ab. Wenn Du immer noch auf Deinen Admin zugreifen kannst, ist ein schneller Weg dies zu tun, indem Du zu „Plugins“ gehst und im Menü der Massenaktionen „Deaktivieren“ auswählst. Dadurch werden alle Deine Plugins deaktiviert. Wenn das Problem dadurch behoben wird, musst Du den Täter finden. Fange an, sie einzeln zu aktivieren und lade die Seite nach jeder Aktivierung neu. Wenn Dein Frontend ausfällt, hast Du das Plugin gefunden, das sich falsch verhält. Du kannst Dich dann an den Plugin-Entwickler wenden, um Hilfe zu erhalten, oder ein Support-Ticket im WordPress-Repository eintragen.

Alle WordPress Plugins deaktivieren

Alle WordPress Plugins deaktivieren

Wenn Du nicht auf Deinen Admin zugreifen kannst, kannst Du FTP auf Deinen Server laden und Deinen Plugins-Ordner in so etwas wie plugins_old umbenennen. Dann überprüfe Deine Seite noch einmal. Wenn es funktioniert, dann musst Du jedes Plugin einzeln testen. Nenne Deinen Plugin-Ordner wieder “ Plugins “ und benenne dann jeden Plugin-Ordner darin um, einen nach dem anderen, bis Du ihn findest.

WordPress Plugin-Ordner umbenennen

WordPress Plugin-Ordner umbenennen

Das Gleiche gilt für Deine WordPress-Thema. Du kannst Dein Thema vorübergehend durch ein Standard-WordPress-Design ersetzen. Twenty Nineteen ist eine gute Wahl. Wenn Du auf Deinen Admin zugreifen kannst, gehe zu „Themes“ im Appearance-Menü, und Du kannst das Twenty Seventeen Design aktivieren und Deine Seite dann erneut testen. Wenn Deine Website wieder auftaucht, liegt das Problem bei Deinem Design.

WordPress Design vorübergehend ausschalten

WordPress Design vorübergehend ausschalten

Wenn Du nicht auf Deinen Admin zugreifen kannst, ist der Prozess genau derselbe wie bei Plugins. Benenne Deinen wp-content/themes-Ordner in etwas anderes um, z.B. themes_old. WordPress kehrt dann zum neuesten Standarddesign zurück, das höchstwahrscheinlich Twenty Nineteen ist (wenn Du keine anderen Designs hast, kannst Du Twenty Nineteen aus dem WordPress Repository herunterladen und in Deinen Themes-Ordner hochladen). Dann überprüfe Deine Seite noch einmal. Wenn sie funktioniert, dann hat Dein Design vielleicht einen Fehler oder ein schlechtes Update und in diesem Fall musst Du Dich unter Umständen an den Entwickler Deines Designs wenden.

WordPress Design-Ordner umbenennen

WordPress Design-Ordner umbenennen

2. Syntaxfehler beheben

Ein weiterer häufiger Grund für den White Screen of Death ist, wenn Du den Code auf Deiner WordPress-Seite bearbeitet hast und Dich versehentlich etwas vertippt hast oder die falsche Syntax hast. Ein falscher Buchstabe am falschen Ort könnte Deine gesamte Website zerstören. Ja, das ist schon etwas beängstigend! Das ist ein Grund, warum Du niemals den Code auf Deiner Live-Produktionsseite bearbeiten solltest.

Aber keine Sorge. Du kannst Dich jederzeit über SFTP mit Deiner Website verbinden und die manuell vorgenommenen Änderungen rückgängig machen. Wenn Du nicht weißt, was die Änderung verursacht hat, solltest Du deshalb WordPress-Backups anbringen. Hier bei Kinsta kannst Du Deine Website mit einem Klick auf einen früheren Zeitpunkt zurücksetzen.

WordPress-Site aus Backup wiederherstellen

WordPress-Site aus Backup wiederherstellen

3. Debugging einschalten

Wenn Du immer noch den White Screen of Death siehst, oder der Admin nicht funktioniert (oder wenn Du den Täter gefunden hast, aber tiefer graben willst), kannst Du Debugging aktivieren, was alle Fehler aufdecken wird. Das Problem ist, dass das Skript bei einem schwerwiegenden Fehler die Ausführung einfach beendet. Wenn dies geschieht, bevor ein Inhalt angezeigt wird, siehst Du nur einen weißen Bildschirm mit absolut keinem Text.

Um das Debugging zu aktivieren, musst Du die Datei wp-config.php Deiner WordPress-Installation öffnen. Darin sollte die folgende Zeile stehen:

define( 'WP_DEBUG', false )

Du musst false durch true ersetzen und Deine Seite neu laden. Wenn es nicht existiert, kannst du es oben hinzufügen.

WP_DEBUG Beispiel

WP_DEBUG Beispiel

Statt des weißen Bildschirms erhältst Du einen weißen Bildschirm und Fehlermeldungen. Keine große Verbesserung, aber zumindest können wir anfangen! Wenn Du Plugins und Designs noch nicht deaktiviert hast, kannst Du anhand der Fehlermeldung herausfinden, bei welchem es sich um den Schuldigen handelt. Es sollte angegeben sein, aus welcher Datei der Fehler stammt, in etwa so:

Cannot redeclare get_posts() (previously declared in /var/www/html/wordpress/wp-includes/post.php:1874) in /var/www/html/wordpress/wp-content/plugins/my-test-plugin/my-test-plugin.php on line 38

Du kannst am Ende der Nachricht sehen, dass das Problem in Zeile 38 eines Plugins namens „my-test-plugin“ liegt. Das Deaktivieren dieses Plugins sollte funktionieren.

Wenn Du mit dem Anpassen des Quellcodes einverstanden bist, kannst Du ihn vielleicht auch reparieren. Wenn es sich um ein Plugin aus dem Repository handelt, empfehle ich, dem Autor zu schreiben, anstatt es selbst zu tun. Wenn Du das Plugin modifizierst, musst Du alle Deine Änderungen beibehalten, was sehr kompliziert ist. Es ist einfacher, es zu deaktivieren, bis es vom Entwickler repariert wird. Wenn Du nach dem Aktivieren des Debuggings überhaupt keine Fehler siehst, musst Du Dich möglicherweise an Deinen Host wenden, da das Debugging auf Deinem Server möglicherweise nicht korrekt konfiguriert ist.

4. Erhöhung der Speicherbegrenzung

Wenn Du immer noch eine leere Seite siehst oder einen Fehler bekommst, der sich über Speichergrenzen oder erschöpften Speicher beklagt, musst Du der Anwendung mehr Speicher zuweisen. Dies kann über die Datei wp-config.php bei vielen Installationen erfolgen und wird durch Hinzufügen des folgenden Codes in die Datei ermöglicht:

define('WP_MEMORY_LIMIT', '64M');

Wenn das nicht funktioniert, hast Du ein paar Möglichkeiten. In einer normalen Umgebung kannst Du Deine.htaccess-Datei – im WordPress-Stammverzeichnis – verwenden, um die Speicherbegrenzung zu erhöhen, indem Du einfach die folgende Zeile hinzufügst:

php_value memory_limit 64M

Wenn Du auf einem fantastischen Host wie Kinsta bist und Deine Website blitzschnell läuft, weil die Architektur NGINX verwendet, ist .htaccess nicht verfügbar. Du kannst deine php.ini-Datei verwenden, um die Speicherbegrenzung zu erhöhen. Füge an beliebiger Stelle innerhalb der Datei die folgende Zeile hinzu:

memory_limit = 64M

Wenn Dein Speicherplatz immer noch knapp ist und Du immer mehr zuweisen musst, kann es zu einem Problem in Deiner Anwendung kommen. Möglicherweise verwendet Dein Design oder eines Deiner Plugins eine übermäßige Menge an Ressourcen. Frag einen Entwickler, ob er einen Blick darauf werfen kann und auch Dein Host kann Dir helfen, indem er Dir die SQL-Protokolle und andere Ressourcenstatistiken anzeigt.

5. Dateiberechtigungsprobleme prüfen

Wir haben deswegen keinen weißen Bildschirm des Todes gesehen, aber Genehmigungs- und Eigentumsprobleme können immer noch Probleme verursachen. Es könnte unter Umständen zu einem weißen Bildschirm des Todes führen! Du kannst das zwar selbst beheben, aber wenn Du nicht wirklich weißt, was Du tust, würden wir davon abraten. Für WordPress gibt es drei einfache Regeln:

  • Dateien sollten 664 oder 644 sein,
  • Ordner sollten 775 oder 755 sein.
  • und die Datei wp-config.php sollte 660, 600 oder 644 sein.

Wenn Du SSH-Zugriff auf Deinen Server hast, kannst Du die entsprechenden Regeln mit dem folgenden Befehl anwenden, indem Du ihn aus dem WordPress-Stammverzeichnis heraus ausführst.

sudo find . -type f -exec chmod 664 {} +
sudo find . -type d -exec chmod 775 {} +
sudo chmod 660 wp-config.php

Wenn Du unsicher bist, wie man das macht oder ein wenig Angst hast, frage Deinen Host. Einige WordPress-spezifische Hosts haben sogar eine automatische Berechtigungsprüfung, die das alles für Dich herausfinden kann.

6. Nach fehlgeschlagenem Auto-Update suchen

Manchmal kann WordPress auf ein Problem mit Updates stoßen, wie z.B. das Timing des Servers. Meistens löst sich das automatisch auf, aber in einigen wilden Fällen kann es zu einem weißen Bildschirm des Todes führen.

Das erste, was Du tun solltest, ist, in Dein WordPress-Stammverzeichnis zu gehen und zu sehen, ob es eine .maintenance-Datei darin gibt. Zögere nicht, diese Datei zu löschen und Deine Seite erneut zu laden. Wenn das Update erfolgreich war, WordPress diese Datei aber nicht automatisch entfernt hat, wird alles wieder normal.

Wenn das Update nicht abgeschlossen wurde, könnte es automatisch für Dich gemacht werden, wobei die Dinge in diesem Fall trotzdem wieder normal werden sollten. Wenn alles andere fehlschlägt, folge dem empfohlenen manuellen WordPress-Aktualisierungsverfahren, das das Problem ein für allemal beheben sollte.

Zusammenfassung

Es gibt eine Reihe von Dingen, die schiefgehen können, aber zum Glück ist die Situation normalerweise nicht so schlimm, wie es scheint. Ein einfacher Plugin/Design-Check sollte das Problem beheben und das Debugging zu aktivieren, wird definitiv zu mehr Klarheit über das Problem führen. Wenn Du schon einmal anderen Situationen mit dem WordPress weißen Bildschirm des Todes begegnet bist, lass es uns wissen, damit wir daraus lernen und die Erfahrungen teilen können!

39
Mal geteilt