Das WordPress-Fehlerprotokoll ist eine Textdatei, in der WordPress automatisch technische Fehler, Warnungen und Hinweise aufzeichnet, die während des Betriebs der Website auftreten. Es ist das wichtigste Werkzeug zur WordPress Fehlerbehebung, weil es genau zeigt, welche Datei, welche Zeile und welches Plugin oder Theme ein Problem verursacht. Die folgenden Abschnitte erklären, wo das Protokoll liegt, wie man es aktiviert und was man damit macht.
Wo wird das WordPress-Fehlerprotokoll gespeichert?
Das WordPress-Fehlerprotokoll wird standardmäßig als Datei namens debug.log im Verzeichnis /wp-content/ gespeichert. Der vollständige Pfad lautet also /wp-content/debug.log. Diese Datei entsteht automatisch, sobald das WordPress-Debug-System aktiviert ist und der erste Fehler auftritt.
Wichtig zu wissen: Solange das Debugging nicht eingeschaltet ist, existiert diese Datei in vielen Installationen gar nicht. Manche Hosting-Anbieter legen das Protokoll an einem anderen Ort ab, zum Beispiel direkt im Stammverzeichnis der Installation oder in einem eigenen Log-Ordner des Servers. Im Zweifel lässt sich die genaue Position über das Hosting-Control-Panel oder per FTP-Zugriff herausfinden. Wer keinen direkten Serverzugang hat, kann auch ein Plugin wie WP Debugging nutzen, das den Pfad transparent anzeigt.
Wie aktiviert man das WordPress-Fehlerprotokoll?
Das WordPress-Fehlerprotokoll aktiviert man, indem man in der Datei wp-config.php drei Konstanten setzt: WP_DEBUG auf true, WP_DEBUG_LOG auf true und WP_DEBUG_DISPLAY auf false. Damit werden Fehler in die debug.log-Datei geschrieben, aber nicht öffentlich auf der Website angezeigt.
Die drei Zeilen werden unmittelbar vor der Zeile /* That's all, stop editing! */ eingefügt:
define( 'WP_DEBUG', true );define( 'WP_DEBUG_LOG', true );define( 'WP_DEBUG_DISPLAY', false );
Die wp-config.php liegt im Stammverzeichnis der WordPress-Installation und kann per FTP, SFTP oder direkt über den Dateimanager des Hosting-Panels bearbeitet werden. WP_DEBUG_DISPLAY sollte unbedingt auf false gesetzt bleiben, damit Fehlermeldungen nicht für Besucher sichtbar werden. Das wäre sowohl eine schlechte Nutzererfahrung als auch ein potenzielles Sicherheitsrisiko.
Was bedeuten die Einträge im Fehlerprotokoll?
Jeder Eintrag im WordPress-Fehlerprotokoll besteht aus einem Zeitstempel, einem Fehlertyp und einem Hinweis auf die betroffene Datei samt Zeilennummer. Der Fehlertyp gibt an, wie schwerwiegend das Problem ist: Ein Fatal error stoppt die Ausführung des Codes vollständig, während eine Warning oder ein Notice meist nur auf ein potenzielles Problem hinweist, das die Seite noch laden lässt.
Die häufigsten Fehlertypen im Überblick:
- PHP Fatal error: Kritischer Fehler, der die Seite oder einen Teil davon zum Absturz bringt. Sofortiger Handlungsbedarf.
- PHP Warning: Warnung über eine unerwartete Situation im Code, die aber noch nicht zum Absturz führt.
- PHP Notice: Hinweis auf möglicherweise unsauberen Code, oft harmlos, aber ein Zeichen für Verbesserungsbedarf.
- PHP Deprecated: Eine Funktion wird genutzt, die in einer neueren PHP-Version nicht mehr empfohlen wird. Langfristig sollte das behoben werden.
Der Dateiname und die Zeilennummer am Ende eines Eintrags sind besonders wertvoll: Sie zeigen direkt, welches Plugin, welches Theme oder welche WordPress-Kerndatei den Fehler ausgelöst hat. So lässt sich das Problem gezielt eingrenzen, ohne die gesamte Installation zu durchsuchen.
Welche häufigen WordPress-Fehler tauchen im Protokoll auf?
Im WordPress debug.log tauchen immer wieder bestimmte Fehlermuster auf. Zu den häufigsten zählen Speicherlimitfehler, Konflikte zwischen Plugins und Themes, veraltete PHP-Funktionen sowie Datenbankverbindungsprobleme. Diese Fehler sind in der Regel lösbar, sobald man sie im Protokoll identifiziert hat.
Plugin- und Theme-Konflikte
Viele Einträge im WordPress-Fehlerprotokoll stammen aus Plugin- oder Theme-Dateien. Wenn zwei Plugins dieselbe Funktion oder Variable definieren, entsteht ein Konflikt, der sich als Fatal error: Cannot redeclare function im Protokoll zeigt. Das betroffene Plugin oder Theme lässt sich direkt am Dateipfad im Eintrag ablesen. Deaktivieren und erneut aktivieren oder ein Update des Plugins lösen solche Konflikte häufig.
Speicher- und Datenbankfehler
Einträge wie Allowed memory size exhausted zeigen, dass WordPress das zugewiesene PHP-Speicherlimit überschreitet. Das Limit lässt sich in der wp-config.php mit define( 'WP_MEMORY_LIMIT', '256M' ); erhöhen, sofern der Hosting-Vertrag das erlaubt. Datenbankfehler wie Error establishing a database connection erscheinen, wenn die Zugangsdaten in der wp-config.php falsch sind oder der Datenbankserver nicht erreichbar ist.
Wann sollte man das Fehlerprotokoll nach dem Beheben deaktivieren?
Das WordPress-Debug-Protokoll sollte deaktiviert werden, sobald das Problem behoben ist. Im Produktivbetrieb hat ein aktiver Debug-Modus nichts verloren: Die debug.log-Datei wächst mit jedem Fehler und jeder Warnung und kann bei viel Traffic schnell mehrere Megabyte groß werden, was die Serverleistung belastet.
Zum Deaktivieren setzt man in der wp-config.php einfach WP_DEBUG wieder auf false. Alternativ kann man die Datei debug.log nach der Analyse löschen, damit keine sensiblen Informationen über die Serverstruktur dauerhaft gespeichert bleiben. Wer regelmäßig an einer WordPress-Website arbeitet, sollte den Debug-Modus als temporäres Diagnosewerkzeug betrachten und nicht als dauerhaften Betriebszustand. Ein gutes WordPress-Wartungspaket beinhaltet auch die Überwachung solcher Konfigurationsdetails.
Was tun, wenn das Fehlerprotokoll nicht weiterhilft?
Wenn das WordPress-Fehlerprotokoll leer ist oder die Einträge keinen klaren Hinweis auf die Ursache geben, gibt es weitere Diagnoseschritte. Manchmal ist der Debug-Modus zwar aktiviert, aber die Fehler entstehen auf einer Ebene, die WordPress selbst nicht erfasst, zum Beispiel bei Serverkonfigurationsfehlern oder Problemen mit dem Webserver-Prozess selbst.
In solchen Fällen helfen folgende Maßnahmen weiter:
- Server-Fehlerprotokolle prüfen: Viele Hosting-Anbieter stellen eigene Apache- oder Nginx-Logs bereit, die Fehler auf Serverebene festhalten.
- Alle Plugins deaktivieren: Wenn die Seite danach funktioniert, liegt ein Plugin-Konflikt vor. Plugins einzeln reaktivieren, bis das Problem wieder auftritt.
- Standard-Theme aktivieren: Ein Theme wie Twenty Twenty-Four schließt Theme-Konflikte als Ursache aus.
- PHP-Version prüfen: Eine nicht kompatible PHP-Version kann Fehler verursachen, die sich nicht immer im debug.log zeigen.
- WordPress-Kerndateien neu installieren: Über das Dashboard unter Updates lassen sich die Kerndateien neu installieren, ohne Inhalte oder Einstellungen zu verlieren.
Wenn diese Schritte nicht zum Ziel führen, ist professionelle Unterstützung sinnvoll. Komplexe Fehler, die sich aus dem Zusammenspiel von Server, PHP-Version, Theme und mehreren Plugins ergeben, lassen sich ohne tiefes technisches Wissen kaum zuverlässig lösen. Ein WordPress-Sicherheitscheck kann dabei helfen, versteckte Probleme systematisch aufzudecken.
So hilft WP-Profi bei der WordPress-Fehlerbehebung
Fehler in WordPress können frustrierend sein, besonders wenn das Fehlerprotokoll zwar Einträge zeigt, die Ursache aber unklar bleibt. Genau hier setzen wir an. Als spezialisierte WordPress-Agentur für Unternehmen im DACH-Raum bieten wir gezielte Unterstützung bei allen Arten von WordPress-Fehlern:
- WordPress-Support auf Deutsch: Wir analysieren das debug.log und identifizieren die Fehlerursache, ohne dass Sie sich in technische Details einarbeiten müssen.
- Notfallsupport an Wochenenden und Feiertagen: Wenn die Website ausfällt, helfen wir auch außerhalb der regulären Geschäftszeiten schnell und zuverlässig.
- Proaktive Wartung: Unsere Wartungspakete ab 14 Euro monatlich beinhalten regelmäßige Updates, Sicherheitsüberwachung und tägliche Backups, damit Fehler gar nicht erst entstehen.
- Individuelle Fehlerbehebung: Von Plugin-Konflikten über Datenbankprobleme bis hin zu Serverfehlern lösen wir technische Probleme nachhaltig und dokumentiert.
Wer sich nicht selbst durch Fehlerprotokolle arbeiten möchte, ist bei uns in guten Händen. Termin vereinbaren und wir schauen uns das Problem gemeinsam an.
Ähnliche Artikel
- Wie erkenne ich, ob meine WordPress-Seite technische Probleme hat?
- Was kostet es, eine jahrelang vernachlässigte WordPress-Seite wieder fit zu machen?
- Was ist „Time to First Byte" (TTFB) bei WordPress und warum ist er wichtig?
- Was ist ein WordPress DSGVO-konformes Backup und warum ist das wichtig?
- Was passiert, wenn mein SSL-Zertifikat abläuft?
