WordPress Fehlerlog verstehen und kritische Fehler beheben

WordPress-Fehlerlogs sind essenziell, um Ursachen kritischer Fehler auf Websites präzise zu erkennen und zu beheben. Dieser Leitfaden richtet sich an Administratoren, Freelancer und kleinere Agenturen, die Schritt für Schritt lernen möchten, Fehlerarten wie Notices, Warnings, Deprecated und Fatal Errors sicher zu identifizieren, Pluginkonflikte zu testen und das WP_DEBUG-System effektiv zu nutzen, um ihre WordPress-Projekte stabil und sicher zu halten.

Was ist ein WordPress-Fehlerlog?

Ein Fehlerlog in WordPress ist eine Textdatei, in die sämtliche PHP-Fehler, Warnungen und Hinweise geschrieben werden, die die Webseite beim Ausführen des Codes erzeugt. Es ist ein wertvolles Diagnosewerkzeug zur Fehlersuche und Fehlerbehebung, da es genaue Informationen über Zeitpunkt, Ursache, Datei und Zeile des Fehlers enthält.

Unterschied zwischen Notice, Warning, Deprecated und Fatal Error

Notice

Hinweis auf kleinere Probleme oder unsaubere Programmierung. Die Seite funktioniert meist weiter, aber die Hinweise sollten geprüft werden.

Warning

Ernsthaftere Probleme, die potenziell zu Fehlern führen können. Die Ausführung stoppt jedoch meistens nicht sofort.

Deprecated

Warnung, dass veralteter Code verwendet wird, der in zukünftigen Versionen nicht mehr unterstützt wird. Ein Update ist empfehlenswert.

Fatal Error

Schwerwiegender Fehler, der den Seitenaufbau sofort abbricht. Muss umgehend behoben werden, da sonst die Seite nicht angezeigt wird.

Was bedeutet „There has been a critical error on this website“?

Diese Meldung erscheint meist bei einem Fatal Error. WordPress aktiviert automatisch den Recovery Mode, der verhindert, dass die ganze Seite offline geht. Hier können Administratoren den Fehler im Backend eingrenzen oder Plugins/Themes vorübergehend deaktivieren.

WP_DEBUG, WP_DEBUG_LOG und WP_DEBUG_DISPLAY verstehen

Diese drei Konstanten in der wp-config.php steuern das Debugging:

WP_DEBUG: Aktiviert die Fehlerberichterstattung.
WP_DEBUG_LOG: Speichert Fehler in der Datei wp-content/debug.log.
WP_DEBUG_DISPLAY: Steuert die Anzeige der Fehler im Browser.

Empfohlen ist, WP_DEBUG und WP_DEBUG_LOG zu aktivieren, aber WP_DEBUG_DISPLAY auszuschalten, um sensible Fehlerdetails nicht öffentlich sichtbar zu machen.

Speicherorte der Fehlerlogs: debug.log und PHP-Error-Logs beim Hosting

Das WordPress-eigene debug.log liegt normalerweise im Verzeichnis wp-content/. Viele Hosting-Anbieter führen zusätzlich eigene PHP-Error-Logs, die oft im Hosting-Control-Panel abrufbar sind. Dort können auch Server-Fehler, die WordPress nicht direkt meldet, sichtbar werden.

Aufbau einer typischen Fehlermeldung verstehen

Eine typische PHP-Fehlermeldung enthält folgende Elemente:

Fehlertyp: z.B. Fatal error oder Warning
Fehlermeldung: Beschreibung, z.B. „Uncaught TypeError“
Dateipfad: Wo im System der Fehler auftrat
Zeilennummer: In welcher Datei
Stack Trace: Rückverfolgung des Programmflusses bei komplexen Fehlern

Beispiel 1: Fatal Error

Beispiel einer PHP Fatal Error Logdatei mit markierter Fehlerstelle

PHP Fatal error: Uncaught TypeError: Argument 1 passed to Example_Plugin::do_action() must be of the type string, array given in /wp-content/plugins/example/plugin.php on line 42

Analyse Schritt für Schritt:

Fehlertyp: Fatal error – sofortiger Abbruch.
Ursache: Ein Funktionsaufruf übergibt falschen Datentyp (string erwartet, array erhalten).
Datei und Zeile: plugin.php in Zeile 42.
Plugin identifizieren: Fehler liegt im Plugin „example“.

Beispiel 2: Warning mit Stack Trace

Beispiel einer PHP Warning mit Stack Trace Log-Meldung

Warning: include(): Failed opening '/wp-content/themes/theme1/inc/helper.php' for inclusion (include_path='.:/usr/share/php') in /wp-content/themes/theme1/functions.php on line 10
Call Stack:
#0 /wp-content/themes/theme1/functions.php(10): include()
#1 /wp-includes/class-wp-hook.php(303): require_once('/wp-content/themes/theme1/functions.php')

Analyse:

Eine Datei wird nicht gefunden oder ist nicht lesbar (include()).
Fehler liegt im aktiven Theme im Verzeichnis theme1.
Stack Trace zeigt den Aufrufpfad, beginnend mit functions.php am Versagenspunkt.

Wie erkennt man, ob Plugin oder Theme den Fehler verursacht?

Anhand des Dateipfads in der Fehlermeldung lässt sich der Urheber oft eingrenzen:

Pfad /wp-content/plugins/ weist auf ein Plugin hin.
Pfad /wp-content/themes/ deutet auf das aktive Theme.

Im Recovery Mode können betroffene Erweiterungen deaktiviert und so getestet werden.

Plugin-Konflikte systematisch testen

Der beste Weg, Plugin-Konflikte zu finden, ist:

Alle Plugins deaktivieren und prüfen, ob der Fehler verschwindet.
Plugins einzeln oder in kleinen Gruppen aktivieren und testen.
So das fehlerverursachende Plugin eingrenzen.

Warum Fehler nach Updates auftreten können

Updates ändern Code, Funktionen und Abhängigkeiten. Diese Änderungen können mit alter benutzerdefinierter Logik, Plugins oder Themes konfligieren und Fehler verursachen. Deshalb sind Testumgebungen vor Updates wichtig.

Was tun, wenn wp-admin nicht mehr erreichbar ist?

Recovery Mode

WordPress schickt per Mail einen Link zur Fehlerbehebung und ermöglicht Admins, problematische Plugins/Themes zu deaktivieren.

FTP oder Hosting File Manager

Plugins per Umbenennung im Verzeichnis wp-content/plugins deaktivieren, Themes auf Standard setzen, Debugging aktivieren.

Warum vor Fixes Änderungen sichern?

Backups schützen vor Datenverlust und ermöglichen Rückschritte bei Fehlern, wenn die Korrektur nicht wie erwartet funktioniert. Sicherung vor Änderungen ist Pflichtpraxis.

Fehler sicher reproduzieren

Ein nachvollziehbarer Fehler ist einfacher zu beheben. Dokumentieren Sie Schritte, Eingaben und Systembedingungen, um Fehler zuverlässig in einer sicheren Testumgebung nachzustellen.

LeonLab: Fehleranalyse und Fix-Vorbereitung

Mit LeonLab.ai können WordPress-Fehlerlogs im Chat analysiert, Fehlerursachen schnell erkannt und passende Code-Snippets oder Pluginfixes vorbereitet werden. Die Plattform unterstützt bei der Versionierung, Prüfung und sicheren Verteilung von Korrekturen, so dass zeitnah und sicher auf Fehler reagiert werden kann.

Wichtiger Hinweis

Ignorieren Sie Notices und Deprecated-Meldungen nicht dauerhaft. Sie verursachen zwar selten sofort Fehler, können längerfristig aber zu Problemen führen. Fatal Errors müssen sofort behoben werden, da sie die Website komplett lahmlegen.

Praktische Checkliste zur Fehlerbehebung

Zeitpunkt der Fehlermeldung prüfen: Wann trat der Fehler auf?
Letztes Update identifizieren: Plugins, Themes, WordPress-Core?
Log-Datei öffnen: wp-content/debug.log und PHP-Logs prüfen.
Plugin oder Theme bestimmen: Fehlermeldungen analysieren.
Änderung auf Testsystem reproduzieren: Nachstellen unter sicherer Umgebung.
Fix testen: Fehlerursache korrigieren und prüfen.
Live-System kontrolliert aktualisieren: Fix einspielen, Backup erstellen.

FAQ

Was ist der Unterschied zwischen WP_DEBUG und WP_DEBUG_LOG? WP_DEBUG aktiviert die Ausgabe von Fehlermeldungen im Code, während WP_DEBUG_LOG zusätzlich die Meldungen in einer Logdatei speichert. Wo finde ich das WordPress-Fehlerlog? Standardmäßig liegt die debug.log im Verzeichnis wp-content/ Ihres WordPress-Installationspfads. Wie aktiviere ich den WordPress Recovery Mode? Der Recovery Mode wird automatisch aktiviert, wenn ein Fatal Error erkannt wird und sendet Admins per Mail einen Wiederherstellungslink. Wie kann ich einen Plugin-Konflikt systematisch erkennen? Deaktiviere alle Plugins und aktiviere sie einzeln erneut, bis der Fehler auftritt – so lässt er sich eingrenzen. Kann ich Fehlerlogs auch über mein Hosting-Panel einsehen? Ja, viele Hoster bieten PHP-Fehlerlogs im Backend an, die ergänzend zu WordPress-Logs genutzt werden können. Kann ich das mit LeonLab.ai machen? Ja. Mit LeonLab.ai kannst du WordPress-Fehlerlogs im Chat analysieren lassen, fehlerhafte Code-Snippets automatisch identifizieren und maßgeschneiderte Fixes erstellen. So sparst du Zeit bei der Fehlersuche und sicherst die Qualität deiner Website.