Zum Hauptinhalt springen

Beta

Live-Demo

WordPress-Debug-Log lesen

Fehlerhinweise im Debug-Log auswerten.

Wenn ein WordPress-Fehler nur bei einer bestimmten Aktion auftritt, kannst du in WPHAVE aktuelle PHP-Hinweise und Fehlermeldungen prüfen. Öffne Website-Cockpit → Website-Verwaltung → Betrieb → Debug-Log. Die Ansicht liest die von der Installation gemeldete Protokolldatei, ohne dass du sie auf dem Server öffnen musst. Sie ersetzt keine vollständige Server- oder Browserdiagnose.

Eine Meldung einem Ablauf zuordnen

  1. Notiere, wann und bei welcher Aktion der Fehler auftritt: Seitenaufruf, Speichern im Editor, Formularversand oder geplante Aufgabe. Reproduziere den Ablauf möglichst einmal.
  2. Klicke unter Debug-Log auf Aktualisieren. Rechts siehst du, ob eine Datei verfügbar ist, wie viele Einträge geladen wurden und ob schwerwiegende Fehler erkannt wurden.
  3. Öffne Protokolleinträge anzeigen. Filtere die gelesenen Einträge nach Alle, Fatal, Warnungen oder Hinweise. Vergleiche den Zeitstempel und den betroffenen Dateipfad mit deinem Test; ein alter Eintrag muss nicht die aktuelle Ursache sein.
  4. Falls die gesuchte Meldung im geladenen Ausschnitt fehlt, vergrößere unter Lesefenster den Umfang der zuletzt gelesenen Datei und aktualisiere erneut. Die Auswahl reicht von 256 KB bis 2 MB. Sie lädt nicht automatisch das gesamte Log.

Mit Sichtbares Log kopieren kopierst du nur die gerade gefilterten Zeilen. Prüfe kopierte Inhalte vor dem Teilen: Logzeilen können Pfade, URLs oder andere betriebliche Informationen enthalten. Gib einem Dienstleister den relevanten Zeitraum und die auslösende Aktion dazu, damit er den Eintrag einordnen kann.

Debug-Einstellungen verstehen

Im Abschnitt Debug-Konstanten zeigt WPHAVE die wirksamen Werte von WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY, SCRIPT_DEBUG und SAVEQUERIES. Diese Werte können aus der WordPress-Konfiguration, Hosting-Umgebung, Plugins oder Drop-ins stammen. WP_DEBUG_LOG steuert die Protokollierung; WP_DEBUG_DISPLAY kann Meldungen auf öffentlichen Seiten ausgeben und sollte auf Produktionsseiten normalerweise aus bleiben. SAVEQUERIES verursacht zusätzlichen Laufzeitaufwand. Die Ansicht zeigt die Werte an, ändert sie aber nicht. Für den größeren Zusammenhang siehe Laufzeit und WordPress-Konfiguration prüfen.

Hinweis: In WordPress erzeugt WP_DEBUG_LOG nur dann Debug-Einträge, wenn WP_DEBUG ebenfalls aktiv ist. Ein leeres Log beweist deshalb nicht, dass der untersuchte Ablauf fehlerfrei war. Prüfe die wirksamen Konstanten, reproduziere den Fehler gezielt und aktualisiere danach das Lesefenster. Lasse WP_DEBUG_DISPLAY auf produktiven Websites aus, damit Meldungen nicht öffentlich erscheinen. Nach der Untersuchung sollte eine nur vorübergehend aktivierte Debug-Protokollierung wieder deaktiviert werden; die WPHAVE-Ansicht ändert diese Konstanten nicht.

Logdatei erst nach der Auswertung leeren

Wenn du einen bekannten Ausgangspunkt für einen erneuten Test brauchst, sichere zuerst die benötigten Zeilen. Dateiinhalt leeren steht nur bei vorhandener, beschreibbarer Datei und passender Berechtigung zur Verfügung. Der Bestätigungsdialog weist darauf hin, dass das Leeren nicht rückgängig gemacht werden kann. Leere das Log erst nach der Auswertung und reproduziere anschließend genau einen Ablauf, damit neue Einträge leichter zuzuordnen sind. Fehlt die Datei oder ist sie nicht beschreibbar, prüfe die Server- und WordPress-Konfiguration statt die Aktion zu erzwingen.

Wichtig: „Dateiinhalt leeren“ ist nicht rückgängig zu machen. Sichere benötigte Logzeilen vor dem Leeren und reproduziere anschließend gezielt einen Ablauf, um neue Einträge zuzuordnen.