🔵
WordPress

WordPress-Debug-Modus aktivieren: komplette Anleitung

📅 8 Oktober 2026 ✏️ 8 Oktober 2026 ⏱ 4 min leestijd

Erfahre, wie du den WordPress-Debug-Modus über wp-config.php aktivierst, Fehler protokollierst und sicher Probleme aufspürst, ohne Risiken auf deiner Live-Site.

Der WordPress-Debug-Modus macht versteckte Fehler, Warnungen und Benachrichtigungen sichtbar, die normalerweise stillschweigend ignoriert werden. Du aktivierst ihn, indem du drei Zeilen zur wp-config.php hinzufügst, wonach Fehler in eine Logdatei geschrieben werden. So spürst du Plugin-Konflikte, Theme-Probleme und PHP-Fehler schnell auf, ohne dass Besucher davon etwas bemerken.

Was ist der WordPress-Debug-Modus?

Der Debug-Modus ist eine integrierte Funktion von WordPress, die PHP-Fehler, Warnungen und Hinweise erfasst und sichtbar oder protokollierbar macht. Standardmäßig ist dieser Modus deaktiviert, sodass Besucher niemals Fehlermeldungen auf deiner Site sehen. Als Administrator oder Entwickler möchtest du diese Meldungen jedoch sehen, zum Beispiel beim Testen eines neuen Themes, beim Installieren von Plugins oder bei der Untersuchung einer weißen Seite (dem bekannten „White Screen of Death“).

Mit dem Debug-Modus kannst du:

  • PHP-Fehler und Warnungen aufspüren
  • Konflikte zwischen Plugins und Themes aufdecken
  • Veraltete Funktionen (deprecated) erkennen
  • Datenbankabfragen und Skriptfehler analysieren
wp-config.phpDebug aktivdebug.log

Debug-Modus über wp-config.php aktivieren

Die Datei wp-config.php enthält die Basiseinstellungen deiner WordPress-Installation und befindet sich im Root-Verzeichnis deiner Site. Du kannst sie über FTP oder über die Dateiverwaltung in Plesk bearbeiten.

1

Verbinde dich mit deinem Hosting-Konto

Melde dich über FTP an oder öffne die Dateiverwaltung in Plesk und navigiere zum Root-Verzeichnis deiner WordPress-Site (meist public_html oder der Ordner deines Domainnamens).

2

Öffne wp-config.php

Suche die Datei im Root-Verzeichnis und öffne sie in einem Texteditor. Erstelle zur Sicherheit zunächst eine Kopie der Datei.

3

Füge die Debug-Konstanten hinzu

Suche die Zeile / That's all, stop editing! / und füge darüber hinzu:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

4

Speichern und überprüfen

Speichere die Datei und besuche deine Site. Fehler erscheinen nicht mehr auf dem Bildschirm, sondern werden nun in wp-content/debug.log geschrieben.

💡 Tipp: Aktiviere WP_DEBUG_DISPLAY nur während des Testens in einer separaten Entwicklungsumgebung auf true, niemals auf deiner Live-Site.

Die Debug-Logdatei verwenden

Sobald WP_DEBUG_LOG aktiviert ist, zeichnet WordPress jeden Fehler in wp-content/debug.log auf. Diese Datei enthält Zeitstempel, Fehlermeldungen und den Dateinamen, in dem der Fehler auftritt, was genau mitteilt, wo du suchen musst.

Du öffnest die Logdatei über die Dateiverwaltung in Plesk oder über FTP mit einem Texteditor. Bei großen Sites kann diese Datei schnell wachsen, kontrolliere sie daher regelmäßig und lösche oder archiviere sie, sobald du mit dem Debuggen fertig bist, damit sie keinen unnötigen Speicherplatz einnimmt.

Erkennst du in der Logdatei eine Meldung zu einem bestimmten Plugin oder einer Theme-Datei, weißt du sofort, wo das Problem liegt. So kannst du gezielt ein Plugin aktualisieren, deaktivieren oder den betreffenden Code anpassen.

Sicher debuggen auf einer Live-Site

Das Aktivieren des Debug-Modus auf einer Produktionssite birgt Risiken, wenn Fehler für Besucher sichtbar werden: Dies kann sensible Informationen über deinen Serverpfad oder deine Konfiguration preisgeben. Halte daher auf einer Live-Site immer diese Kombination ein:

  • WP_DEBUG auf true, damit Fehler erfasst werden
  • WP_DEBUG_LOG auf true, damit sie protokolliert werden
  • WP_DEBUG_DISPLAY auf false, damit sie nie auf dem Bildschirm erscheinen

Arbeitest du lieber in einer separaten Testumgebung, ist das der sicherste Weg: Nimm dort Änderungen vor, teste sie gründlich und schalte den Debug-Modus erst danach wieder aus, bevor du live gehst. Vergiss auch nicht, nach dem Debuggen die Zeilen wieder zu entfernen oder auf false zu setzen, damit deine Site nicht unnötig protokolliert.

Stößt du auf hartnäckige Fehler, die nicht in der Logdatei erklärt werden, überprüfe dann auch die Einstellungen deiner Webhosting-Umgebung oder konsultiere die Wissensdatenbank für mehr Hintergrundinformationen.

Häufig gestellte Fragen

Kann ich den Debug-Modus auf meiner Live-Site aktivieren?

Ja, sofern du WP_DEBUG_DISPLAY auf false setzt. Fehler werden dann nur protokolliert, nicht den Besuchern angezeigt.

Wo finde ich die Datei debug.log?

Im Ordner wp-content/debug.log, zu öffnen über FTP oder die Dateiverwaltung in Plesk.

Wie schalte ich den Debug-Modus wieder aus?

Setze WP_DEBUG auf false oder entferne die drei Debug-Zeilen vollständig aus wp-config.php.

Hat der Debug-Modus Einfluss auf die Geschwindigkeit meiner Site?

Das Logging kostet etwas zusätzliche Verarbeitungszeit, aber das ist in Testumgebungen vernachlässigbar. Schalte es daher auf deiner Live-Site aus, sobald du fertig bist.

Ich sehe keine Datei debug.log, was nun?

Überprüfe, ob der Ordner wp-content Schreibrechte hat und ob die drei Zeilen korrekt und ohne Tippfehler zur wp-config.php hinzugefügt wurden.

Fazit

Den WordPress-Debug-Modus aktivierst du, indem du drei Zeilen zur wp-config.php hinzufügst. So zeichnest du Fehler in einer Logdatei auf, ohne sie für Besucher sichtbar zu machen. Kontrolliere die Logdatei regelmäßig, schalte den Debug-Modus nach der Nutzung wieder aus und arbeite bei größeren Änderungen vorzugsweise in einer Testumgebung.

Webhosting ansehen →

Was dit artikel nuttig?