WordPress Debug-Modus aktivieren („WP_DEBUG“) – Fehler sicher loggen & analysieren

Du sitzt vor deiner WordPress-Website, alles sieht schick aus, die Farben stimmen, die Buttons glänzen – und plötzlich: Fehler 500. Oder schlimmer noch, eine weiße Seite, das berühmte „White Screen of Death“. Panik? Nicht mit dir! Denn heute tauchen wir gemeinsam tief in die Welt des WordPress Debug-Modus ein. Ich zeige dir, wie du mit WP_DEBUG Fehler nicht nur sichtbar machst, sondern sie auch sicher loggst und analysierst. Und das alles, ohne dass du dabei graue Haare bekommst (außer, du findest sie schick – dann nur zu!).

WordPress ist das beliebteste Content-Management-System der Welt. Laut W3Techs laufen über 43% aller Websites im Internet mit WordPress. Das ist beeindruckend – aber auch ein Grund, warum Fehler und Bugs hier zum Alltag gehören. Egal ob du ein Plugin installierst, ein Theme anpasst oder ein Update durchführst: Irgendwo kann immer etwas schiefgehen. Und genau deshalb ist der Debug-Modus so wichtig.

Doch was ist eigentlich der Debug-Modus in WordPress? Wie aktivierst du ihn, wie loggst du Fehler sicher und wie analysierst du sie, ohne dass deine Besucher:innen gleich alles mitbekommen? Und wie bleibt deine Seite dabei DSGVO-konform und sicher? All das (und noch viel mehr) erfährst du jetzt. Also: Kaffee holen, Ärmel hochkrempeln – los geht’s!

Inhalt:

Was ist der WordPress Debug-Modus?
Warum solltest du WP_DEBUG aktivieren?
So aktivierst du den Debug-Modus (Schritt-für-Schritt-Anleitung)
Fehler sicher loggen: WP_DEBUG_LOG & Co.
Fehleranalyse: So liest du das Logfile richtig
Debugging-Tools & Plugins für Profis
DSGVO & Sicherheit beim Debugging
Häufige Fehlerquellen und Best Practices
Wie Nakaryu dich beim Debugging und Webdesign unterstützt
Quellen

Was ist der WordPress Debug-Modus?

Der Debug-Modus ist eine spezielle Funktion in WordPress, die dir hilft, Fehler und Warnungen im Code sichtbar zu machen. Standardmäßig sind diese Meldungen aus gutem Grund deaktiviert – niemand möchte, dass Besucher:innen kryptische PHP-Fehler auf der Website sehen. Doch für Entwickler:innen und Admins ist der Debug-Modus Gold wert: Er zeigt dir, wo es im Code hakt, welche Funktionen veraltet sind (Stichwort: „deprecated“) und wo du nachbessern solltest.

Die wichtigsten Konstanten im WordPress-Debugging sind:

WP_DEBUG: Schaltet den Debug-Modus ein oder aus.
WP_DEBUG_LOG: Schreibt Fehler in eine Logdatei (wp-content/debug.log).
WP_DEBUG_DISPLAY: Steuert, ob Fehler auf der Website angezeigt werden.
SCRIPT_DEBUG: Lädt nicht-minimierte Versionen von CSS- und JS-Dateien (für Entwickler:innen).

Warum solltest du WP_DEBUG aktivieren?

Fehler frühzeitig erkennen: Viele Fehler bleiben im Alltag unbemerkt, weil sie nicht direkt zu sichtbaren Problemen führen. Mit aktiviertem Debug-Modus siehst du auch Warnungen und Hinweise, die später zu echten Bugs werden könnten.
Veraltete Funktionen aufspüren: WordPress entwickelt sich ständig weiter. Funktionen, die heute noch laufen, können morgen schon „deprecated“ sein. Der Debug-Modus warnt dich rechtzeitig.
Performance optimieren: Fehler und Warnungen können die Ladezeit deiner Seite beeinflussen. Wer sauber arbeitet, hat schnellere Websites – und das freut nicht nur Google, sondern auch deine Besucher:innen.
Sicherheit erhöhen: Fehler im Code können Sicherheitslücken verursachen. Mit dem Debug-Modus findest du sie, bevor es Angreifer tun.

Siehe auch Bewertungen auf WordPress Websites einbinden: Recht & Technik [Ratgeber]

So aktivierst du den Debug-Modus (Schritt-für-Schritt-Anleitung)

Backup machen! Bevor du irgendetwas an deiner Website änderst, solltest du ein Backup erstellen. Das ist wie der Sicherheitsgurt beim Autofahren – du hoffst, ihn nie zu brauchen, aber wenn doch, bist du froh, dass er da ist.
Öffne die wp-config.php: Diese Datei findest du im Hauptverzeichnis deiner WordPress-Installation. Am besten lädst du sie per FTP oder über das Dateiverwaltungstool deines Hosters herunter.
Füge die Debug-Konstanten ein: Suche nach der Zeile /* That's all, stop editing! Happy publishing. */ und füge vorher folgende Zeilen ein:
```
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
```
- WP_DEBUG auf true: Aktiviert den Debug-Modus.
- WP_DEBUG_LOG auf true: Schreibt alle Fehler in die Datei wp-content/debug.log.
- WP_DEBUG_DISPLAY auf false: Verhindert, dass Fehler auf der Website angezeigt werden (wichtig für Live-Seiten!).
Datei speichern und hochladen: Speichere die wp-config.php und lade sie zurück auf den Server.
Fehler testen: Rufe deine Website auf und provoziere ggf. einen Fehler (z.B. durch Deaktivieren eines Plugins). Schau nach, ob die Datei wp-content/debug.log erstellt wurde.

Fehler sicher loggen: WP_DEBUG_LOG & Co.

Das Loggen von Fehlern ist ein zentraler Bestandteil des Debuggings. Mit WP_DEBUG_LOG werden alle Fehler, Warnungen und Hinweise in die Datei wp-content/debug.log geschrieben. Das hat gleich mehrere Vorteile:

Keine Fehlerausgabe für Besucher:innen: Deine User sehen keine unschönen Fehlermeldungen – alles bleibt im Hintergrund.
Zentrale Fehlerübersicht: Du hast alle Fehler an einem Ort und kannst sie gezielt analysieren.
Langfristige Analyse: Auch Fehler, die nur sporadisch auftreten, werden geloggt und können später ausgewertet werden.

Ein kleiner Tipp aus der Praxis: Lösche die debug.log regelmäßig oder archiviere sie, damit sie nicht zu groß wird. Und: Achte darauf, dass die Datei nicht öffentlich zugänglich ist! Am besten schützt du sie mit einer .htaccess-Regel:

<Files debug.log>
  Order allow,deny
  Deny from all
</Files>

Fehleranalyse: So liest du das Logfile richtig

Die debug.log kann auf den ersten Blick einschüchternd wirken – kryptische Fehlermeldungen, Zeilennummern, Dateipfade. Aber keine Sorge, mit ein bisschen Übung wirst du zum Logfile-Profi!

Fehlertypen unterscheiden: Es gibt Notices (Hinweise), Warnings (Warnungen) und Fatal Errors (schwerwiegende Fehler). Fatal Errors sind am kritischsten, sie können deine Seite lahmlegen.
Fehlerursache finden: Die Meldung enthält meist den Dateipfad und die Zeilennummer, wo der Fehler aufgetreten ist. Beispiel:
```
[12-Jun-2024 10:15:23 UTC] PHP Fatal error:  Uncaught Error: Call to undefined function example_function() in /home/user/public_html/wp-content/themes/mytheme/functions.php:42
```
Hier siehst du: In der Datei functions.php in Zeile 42 wird eine nicht definierte Funktion aufgerufen.
Google ist dein Freund: Kopiere die Fehlermeldung (ohne Pfadangaben) und suche danach. Oft findest du in Foren oder auf wordpress.org/support Lösungen.
Logfile filtern: Bei vielen Einträgen hilft es, das Logfile mit einem Editor zu durchsuchen oder nach bestimmten Begriffen zu filtern.

Debugging-Tools & Plugins für Profis

Manchmal reicht der klassische Debug-Modus nicht aus. Dann kommen spezielle Tools und Plugins ins Spiel, die dir das Leben leichter machen:

Query Monitor: Zeigt dir Datenbankabfragen, PHP-Fehler, Hooks und vieles mehr direkt im Backend an. Ein Must-have für Entwickler:innen. Zum Plugin
Debug Bar: Fügt eine Debug-Leiste im Admin-Bereich hinzu, mit Infos zu Fehlern, Abfragen und mehr. Zum Plugin
Health Check & Troubleshooting: Prüft die Gesundheit deiner Website und hilft beim Identifizieren von Problemen. Zum Plugin
Log Deprecated Notices: Zeigt dir, welche Funktionen veraltet sind und ersetzt werden sollten. Zum Plugin

DSGVO & Sicherheit beim Debugging

Fehlerlogs können sensible Daten enthalten – z.B. Benutzernamen, E-Mail-Adressen oder sogar Passwörter (hoffentlich nicht, aber man weiß ja nie). Deshalb ist es wichtig, beim Debugging auf Datenschutz und Sicherheit zu achten:

Logdateien schützen: Wie oben beschrieben, sollte die debug.log nicht öffentlich zugänglich sein.
Logs regelmäßig löschen: Halte die Logdateien so klein wie möglich und lösche sie nach der Fehleranalyse.
Keine sensiblen Daten loggen: Achte darauf, dass keine personenbezogenen Daten in den Logs landen. Plugins wie „WP GDPR Compliance“ können helfen.
Debug-Modus nur temporär aktivieren: Schalte den Debug-Modus nach der Analyse wieder aus, um keine unnötigen Risiken einzugehen.

Häufige Fehlerquellen und Best Practices

Plugin-Konflikte: Viele Fehler entstehen durch inkompatible oder schlecht programmierte Plugins. Deaktiviere testweise alle Plugins und aktiviere sie einzeln wieder, um den Übeltäter zu finden.
Theme-Probleme: Ein fehlerhaftes Theme kann die ganze Seite lahmlegen. Wechsle testweise auf ein Standard-Theme (z.B. Twenty Twenty-Four), um zu prüfen, ob das Problem am Theme liegt.
PHP-Version: WordPress empfiehlt mindestens PHP 7.4 oder höher (Quelle). Viele Fehler entstehen durch veraltete PHP-Versionen.
Dateiberechtigungen: Falsche Berechtigungen können dazu führen, dass WordPress keine Logs schreiben kann. Prüfe, ob wp-content und debug.log die richtigen Rechte haben (meist 644 für Dateien, 755 für Ordner).
Regelmäßige Updates: Halte WordPress, Themes und Plugins immer aktuell, um Fehler und Sicherheitslücken zu vermeiden.

Wie Nakaryu dich beim Debugging und Webdesign unterstützt

Du hast jetzt das geballte Debugging-Wissen – aber manchmal fehlt einfach die Zeit, die Nerven oder das Know-how, um sich durch endlose Logfiles zu wühlen. Genau hier kommen wir von Nakaryu ins Spiel! Seit 2017 helfen wir Unternehmen, Start-ups, Künstler:innen und Organisationen in ganz Deutschland (und darüber hinaus), ihre WordPress-Websites nicht nur schön, sondern auch technisch einwandfrei zu machen.

Ob Fehleranalyse, Performance-Optimierung, DSGVO-Check oder kompletter Relaunch – wir bieten dir individuelle Lösungen, die zu deinem Projekt passen. Und das Beste: Mit unseren Webdesign-Flatrates bekommst du alles aus einer Hand, zum monatlichen Fixpreis, ohne versteckte Kosten. Klingt spannend? Dann schau dir unsere Webdesign-Angebote an und lass uns gemeinsam deine Website auf das nächste Level bringen!

Und jetzt: Viel Erfolg beim Debuggen – und denk dran, Fehler sind nur die Würze im Entwickler:innen-Leben. Ohne sie wäre es doch langweilig, oder?

Quellen

Fragen zum Thema

Was ist der WordPress Debug-Modus und wofür wird er verwendet?

Der Debug-Modus in WordPress ist eine spezielle Funktion, mit der Fehler, Warnungen und veraltete Funktionen (deprecated) im Code sichtbar gemacht werden. Er hilft Entwickler:innen und Admins dabei, Probleme frühzeitig zu erkennen und gezielt zu beheben, ohne dass Besucher:innen die Fehlermeldungen sehen.

Wie aktiviere ich WP_DEBUG in meiner WordPress-Installation?

Um WP_DEBUG zu aktivieren, öffne die Datei wp-config.php im Hauptverzeichnis deiner WordPress-Installation. Füge vor der Zeile /* That's all, stop editing! Happy publishing. */ folgende Zeilen ein:
define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false );
Speichere die Datei und lade sie zurück auf den Server. Nun werden Fehler im Hintergrund geloggt, ohne für Besucher:innen sichtbar zu sein.

Wie kann ich Fehler sicher loggen und die debug.log vor Zugriff schützen?

Mit WP_DEBUG_LOG werden alle Fehler in die Datei wp-content/debug.log geschrieben. Um diese Datei vor unbefugtem Zugriff zu schützen, solltest du sie mit einer .htaccess-Regel absichern:
<Files debug.log> Order allow,deny Deny from all </Files>
Außerdem empfiehlt es sich, die debug.log regelmäßig zu löschen oder zu archivieren, damit sie nicht zu groß wird.

Welche häufigen Fehlerquellen gibt es beim Debugging in WordPress?

Typische Fehlerquellen sind Plugin-Konflikte, fehlerhafte Themes, eine veraltete PHP-Version, falsche Dateiberechtigungen oder nicht aktuelle WordPress-Installationen. Es hilft, Plugins und Themes einzeln zu deaktivieren/aktivieren und die PHP-Version sowie Dateirechte zu prüfen.

Wie bleibt das Debugging DSGVO-konform und sicher?

Achte darauf, dass Logdateien wie die debug.log nicht öffentlich zugänglich sind und keine personenbezogenen Daten enthalten. Lösche oder archiviere Logs regelmäßig und aktiviere den Debug-Modus nur temporär. Plugins wie „WP GDPR Compliance“ können zusätzlich unterstützen.