Wie Sie einen „Critical Error“ in WordPress erkennen und beheben

Die Meldung „There has been a critical error on your website“ gehört zu den häufigsten Problemen in WordPress. Meist entsteht sie durch Konflikte mit Plugins oder Themes bzw. durch Fehler im Code.

In dieser Anleitung erfahren Sie, wie Sie die Fehlerquelle mit dem WordPress-Debug-Modus (WP_DEBUG) erkennen und wie Sie die wp-config.php Datei bearbeiten, um diesen Modus zu aktivieren.

Schritte zur Identifikation und Behebung des Problems

1. WP_DEBUG aktivieren

WP_DEBUG ist eine Konstante in WordPress, die das Anzeigen von Fehler- und Warnmeldungen ermöglicht.

So aktivieren Sie WP_DEBUG:

1. Verbinden Sie sich mit Ihrem Server
   • Nutzen Sie einen FTP-Client wie FileZilla oder den Dateimanager in cPanel, um auf Ihre WordPress-Dateien zuzugreifen.
2. Finden Sie die Datei wp-config.php
   • Diese Datei befindet sich im Stammverzeichnis Ihrer WordPress-Installation.
3. Laden Sie die wp-config.php auf Ihren Computer herunter
   • Rechtsklick auf die Datei und „Download“ wählen.
4. Bearbeiten Sie die Datei wp-config.php
   • Öffnen Sie die Datei in einem Texteditor wie Notepad++ oder Visual Studio Code.
   • Suchen Sie die Zeile: define('WP_DEBUG', false);
   • Falls die Zeile fehlt, fügen Sie vor /* That's all, stop editing! Happy publishing. */ folgende Zeilen ein:
     define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
   • Diese Konfiguration aktiviert WP_DEBUG, schreibt Fehler in ein Log und versteckt sie vor Besuchern.
5. Laden Sie die wp-config.php zurück auf den Server
   • Speichern Sie die Änderungen und überschreiben Sie die bestehende Datei auf dem Server.

2. Prüfen Sie die WP_DEBUG-Logdatei

1. Suchen Sie die Datei debug.log
   • Diese wird automatisch im Ordner /wp-content/ erstellt, sobald Fehler auftreten.
2. Laden Sie die Datei herunter und öffnen Sie sie
   • Analysieren Sie die Fehler, um zu erkennen, welches Plugin, Theme oder welcher Code die Probleme verursacht.
     Beispiel:
     [23-Jan-2025 15:00:00 UTC] PHP Fatal error: Uncaught Error: Call to undefined function example_function() in /wp-content/plugins/example-plugin/example.php:23
   • In diesem Beispiel stammt der Fehler vom Plugin „example-plugin“.

3. Deaktivieren Sie problematische Plugins oder Themes

1. Verbinden Sie sich mit dem Server
   • Wechseln Sie in das Verzeichnis /wp-content/plugins/, um die installierten Plugins zu sehen.
2. Benen­nen Sie den Ordner des fehlerhaften Plugins um
   • Wenn Sie das problematische Plugin identifiziert haben, benennen Sie dessen Ordner z. B. von example-plugin in example-plugin-deactivated um.
3. Testen Sie die Website
   • Überprüfen Sie, ob die Seite nach der Deaktivierung wieder funktioniert. Falls nicht, wiederholen Sie die Schritte mit anderen Plugins oder Themes.

4. WP_DEBUG nach Fehlerbehebung deaktivieren

1. Bearbeiten Sie erneut die wp-config.php
   • Ändern Sie die Zeile:
     define('WP_DEBUG', true); zu
     define('WP_DEBUG', false);
2. Laden Sie die Datei wieder auf den Server hoch
   • Speichern und überschreiben Sie die Datei.

Fazit

Mit aktiviertem WP_DEBUG können Sie die Ursachen kritischer Fehler in WordPress schnell erkennen. Auch wenn die Vorgehensweise zunächst komplex erscheint, helfen Ihnen diese Schritte, Probleme effizient zu diagnostizieren und zu beheben.