WordPress Fehlerprotokoll: wo Sie den Fehler finden und was die Meldungen bedeuten
Das WordPress Fehlerprotokoll sind Dateien, in denen Server, WordPress und Plugins Details zu Fehlern festhalten: die Meldung, die Datei und die Zeile. Suchen Sie an drei Stellen: debug.log im Ordner wp-content (sobald die Protokollierung in wp-config.php eingeschaltet ist), Ihr Hosting-Panel und WooCommerce → Status → Protokolle. Ohne sie ist die Fehlerbehebung Raterei.
Autor: Das TellMyShop-Team. Ein Ratgeber für Betreiber von WordPress-Websites und WooCommerce-Shops: die Ursache, die Lösung von Hand und dieselbe Arbeit im Gespräch mit dem Chat.
Zuletzt aktualisiert: · 5 Min. Lesezeit
Drei Stellen, an denen Sie suchen
Jede dieser Stellen hält etwas anderes fest. Prüfen Sie sie in dieser Reihenfolge, die einfachste zuerst.
| Ort | Was dort landet | Wie Sie hinkommen | Wer meist Zugriff hat |
|---|---|---|---|
| WooCommerce → Status → Protokolle, Datei fatal-errors | schwere PHP-Fehler mit Datei und Zeile | das Dashboard, wenn es funktioniert | Sie |
| debug.log in wp-content | Fehler, Warnungen und Hinweise von WordPress und Plugins | Dateimanager des Hosters oder FTP, sobald die Protokollierung an ist | Sie oder der Betreuer der Website |
| PHP-Fehlerprotokoll auf dem Server | PHP-Fehler, auch wenn WordPress gar nicht lädt | Hosting-Panel | der Hoster, manchmal Sie |
Ein WooCommerce-Shop hat einen Vorteil: Das Protokoll fatal-errors funktioniert, ohne in Dateien zu graben. WooCommerce selbst empfiehlt, dort anzufangen, wie die WooCommerce-Dokumentation zum Finden von PHP-Fehlerprotokollen beschreibt.
debug.log Schritt für Schritt einschalten
Die Protokollierung in debug.log schalten Sie in wp-config.php ein. Diese Datei enthält Ihr Datenbankpasswort, arbeiten Sie also mit einer Kopie und vorsichtig. Sind Sie unsicher, fragen Sie Ihren Hoster oder den Betreuer der Website.
- Machen Sie im Dateimanager des Hosters eine Kopie von wp-config.php.
- Öffnen Sie wp-config.php zum Bearbeiten und suchen Sie die Zeile mit WP_DEBUG.
- Setzen Sie WP_DEBUG auf true, fügen Sie WP_DEBUG_LOG mit true und WP_DEBUG_DISPLAY mit false hinzu.
- Speichern Sie die Datei und wiederholen Sie, was den Fehler auslöst, zum Beispiel die Seite öffnen oder ein Produkt in den Warenkorb legen.
- Öffnen Sie wp-content/debug.log und lesen Sie die letzten Zeilen.
- Wenn Sie fertig sind, setzen Sie WP_DEBUG wieder auf false.
Alle Konstanten und was sie bewirken, beschreibt das WordPress-Handbuch zum Debugging. Eine kurze Erklärung der Datei selbst steht im Glossareintrag von GreenGeeks zu WP Debug Log.
Die Datei debug.log liegt in einem Ordner, der manchmal aus dem Browser erreichbar ist. Lassen Sie die Protokollierung nicht ohne Bedarf dauerhaft an, oder bitten Sie Ihren Hoster, den Zugriff auf diese Datei zu sperren.
Einen Protokolleintrag lesen
Jeder Eintrag hat eine ähnliche Form: Datum und Uhrzeit, Fehlerstufe, Meldung und am Ende der Pfad zur Datei und die Zeilennummer. Am wichtigsten ist der Pfad. Enthält er wp-content/plugins/plugin-name, ist dieses Plugin schuld. Steht dort wp-content/themes/theme-name, ist es das Theme.
Stufen, von der ernstesten an:
- Fatal error: Der Code ist stehen geblieben, und die Seite oder ein Teil davon funktioniert nicht.
- Warning: Etwas ist schiefgegangen, aber die Seite läuft weiter.
- Notice und Deprecated: Hinweise für Entwickler, meist ohne Auswirkung auf Besucher.
Glossar: fünf häufige Meldungen
Allowed memory size of … bytes exhausted. PHP ist der zugeteilte Speicher ausgegangen. Ein schweres Plugin oder ein niedriges Hosting-Limit kann schuld sein. Das Speicherlimit erhöht Ihr Hoster oder der Betreuer der Website.
Call to undefined function … Der Code ruft eine Funktion auf, die es nicht gibt. Eine häufige Ursache ist ein Plugin, das von einem anderen Plugin abhängt, das deaktiviert ist, oder ein Theme, das nach einem Update nicht mehr zu einem Plugin passt.
Maximum execution time of … seconds exceeded. Ein Skript lief länger, als der Server erlaubt. Das passiert bei einem Import, einem großen Backup oder einer langsamen Verbindung zu einem externen Dienst.
Uncaught Error: Class … not found. Ein Teil des Plugin-Codes fehlt, etwa nach einem fehlgeschlagenen Update. Eine Neuinstallation derselben Plugin-Version hilft.
Cannot modify header information - headers already sent. Etwas hat zu früh Text an den Browser geschickt. Sehr oft ist es eine Leerzeile oder ein Leerzeichen am Ende von functions.php nach einer Bearbeitung von Hand.
Die Werte in den Meldungen unterscheiden sich von Website zu Website, daher sind sie durch Auslassungspunkte ersetzt. Zeigt das Protokoll einen schweren Fehler und ist die Website ausgefallen, gehen Sie zum Leitfaden zum kritischen Fehler in WordPress. Bei einem weißen Bildschirm oder dem Code 500 lesen Sie den Beitrag zum 500-Fehler in WordPress.
Was Sie Ihrem Hoster oder Entwickler schicken
Eine gut geschriebene Meldung spart mehrere Runden Nachrichten. Nennen Sie:
- die genaue Meldung aus dem Protokoll, kopiert statt aus dem Gedächtnis abgetippt, zusammen mit Dateipfad und Zeilennummer,
- Datum und Uhrzeit des ersten Auftretens und ob der Fehler immer wieder kommt,
- was sich kurz davor geändert hat: ein Update von Plugin, Theme, WordPress oder PHP-Version,
- auf welcher Seite und bei welcher Aktion der Fehler erscheint, etwa beim Legen in den Warenkorb,
- die Versionen von WordPress und PHP aus Werkzeuge → Website-Zustand → Bericht.
Entfernen Sie vor dem Senden E-Mail-Adressen und andere Kundendaten aus dem Auszug.
Wie der Chat die Protokolle für Sie liest
Das TellMyShop-Plugin für WordPress und WooCommerce liest Fehlerprotokolle schon in TellMyShop Free. Ihr Chat (Claude oder ChatGPT) bekommt die Fehler von PHP, WordPress und WooCommerce der letzten Tage, gruppiert: Dieselbe Meldung ist eine Zeile mit Anzahl und Datum des letzten Auftretens. Zu jeder nennt er das Plugin oder Theme, aus dem sie kommt, und erklärt die Meldung in einfachen Worten. E-Mails, Telefonnummern und IP-Adressen in den Protokollen sind maskiert.
Sie: Seit gestern lädt der Warenkorb manchmal nicht. Sieh dir die Protokolle an.
Ihr Chat: In den letzten zwei Tagen gibt es einen schweren Fehler, gut ein Dutzend Mal wiederholt:
Allowed memory size exhausted, in einer Datei des Plugins für den Versandrechner.
Er erscheint nur, wenn der Warenkorb öffnet. Das Plugin hat gestern eine neue Version bekommen.
Mein Vorschlag: den Fehler dem Autor melden oder zur vorherigen Plugin-Version zurückkehren. Das Speicherlimit ist Sache Ihres Hosters.
Das Ergebnis in diesem Gespräch ist ein Beispiel. Der Chat liest, was festgehalten wurde. Ist die Protokollierung in debug.log aus, steht im WordPress-Protokoll nichts. Der Chat kann sie nicht einschalten: wp-config.php ist für das Plugin immer gesperrt, in jeder Version. Das machen Sie, Ihr Hoster oder der Betreuer der Website.
Protokolle, Website-Zustand und Plugin-Liste zu lesen reicht für eine Diagnose, und das ist kostenlos. Ist ein Plugin die Ursache, kann der Chat es in TellMyShop Pro deaktivieren oder aktualisieren, sobald Sie den Schalter Plugins für 24 Stunden einschalten, immer mit Vorschau und nach Ihrer Zustimmung. Die kostenlose Version laden Sie auf der Seite TellMyShop Free herunter, Pro ist auf der Seite TellMyShop für WordPress und WooCommerce beschrieben, die Unterschiede stehen auf der Seite Preise.
Fragen und Antworten
Wo liegt die Datei debug.log in WordPress?
Standardmäßig im Ordner wp-content, aber nur, wenn WP_DEBUG und WP_DEBUG_LOG in wp-config.php eingeschaltet sind. Die Datei entsteht beim ersten Fehler nach dem Einschalten der Protokollierung. Fehlt sie, ist die Protokollierung aus, oder seit dem Einschalten gab es keine Fehler.
Zeigt das Einschalten von WP_DEBUG Kunden die Fehler?
Das kann passieren, wenn Sie die Fehleranzeige anlassen. Auf einer laufenden Website protokollieren Sie in eine Datei mit ausgeschalteter Anzeige, also WP_DEBUG_DISPLAY auf false. Dann landen Fehler nur in debug.log.
Müssen Deprecated-Warnungen sofort behoben werden?
Meist nicht. Sie sagen, dass ein Plugin oder Theme eine Funktion nutzt, die künftig aus PHP oder WordPress verschwindet. Die Website funktioniert, aber vor einem Wechsel der PHP-Version lohnt es sich, sie dem Plugin-Autor zu melden oder nach einem Update zu suchen.
Kann ein Fehlerprotokoll Kundendaten enthalten?
Ja, manchmal landen dort E-Mail-Adressen, IP-Adressen oder Teile von Anfragen. Stellen Sie also nicht die ganze Datei in ein Forum und lassen Sie die Protokollierung nicht ohne Bedarf an. Das TellMyShop-Plugin maskiert E-Mails, Telefonnummern und IP-Adressen, wenn es Protokolle liest.
Wer hat Zugriff auf die Serverprotokolle?
Ihr Hoster. Die PHP-Fehlerprotokolle des Servers liegen meist im Hosting-Panel, im Bereich Statistik oder Protokolle. Sehen Sie sie dort nicht, bitten Sie den Support um den Auszug aus der Zeit, in der der Fehler auftrat.
WordPress ist eine Marke der WordPress Foundation. WooCommerce ist eine Marke der Automattic Inc. Claude ist eine Marke der Anthropic PBC. ChatGPT und OpenAI sind Marken von OpenAI. TellMyShop ist mit diesen Unternehmen nicht verbunden.