Halten Sie das genaue Fehlerbild und die letzte Änderung fest, erstellen Sie ein Backup und prüfen Sie die PHP-, WordPress- und Serverlogs für denselben Zeitraum. Zeigen Sie Fehler nicht öffentlich an. Isolieren Sie die verdächtige Komponente auf Staging oder über den Recovery Mode, beheben Sie die Grundursache und sichern Sie das Logging nach dem Deployment erneut ab.
Ein kritischer Fehler in WordPress kann eine allgemeine Meldung, eine weiße Seite oder lediglich eine nicht funktionierende Administration anzeigen. Das sichtbare Symptom verrät nicht, ob die Ursache ein PHP-Fehler in einem Plugin, erschöpfter Speicher, eine inkompatible Version, eine beschädigte Datei oder ein Datenbankausfall ist. Willkürliches Deaktivieren und Überschreiben von Dateien in der Produktion kann Beweise vernichten und weitere Abweichungen verursachen.
Eine sichere Diagnose begrenzt zuerst die Auswirkungen, sichert den aktuellen Zustand und erfasst den genauen Zeitpunkt, die URL, die Rolle und die letzte Änderung. Das Logging wird so aktiviert, dass Besucher keine technischen Details sehen. Anschließend wird der Fehler auf dem Staging-System oder in einem kontrollierten Schritt reproduziert, und die Korrektur wird sowohl anhand des ursprünglichen Szenarios als auch anhand weiterer kritischer Funktionen überprüft.
Stabilisieren und dokumentieren Sie zuerst den Vorfall
Prüfen Sie den Umfang: die gesamte Website, nur eine bestimmte URL, die Administration, ein angemeldeter Benutzer oder eine bestimmte Aktion. Notieren Sie die Uhrzeit mit Zeitzone, den Browser, den HTTP-Status und die Schritte zur Reproduktion. Prüfen Sie das Monitoring sowie das letzte Deployment, Update, einen Import oder einen Hostingwechsel. Derselbe Fehler nach einer bestimmten Aktion ist eine wertvollere Spur als ein allgemeines „die Website funktioniert nicht“.
Erstellen Sie vor dem Eingriff ein zugängliches Backup von Datenbank und Dateien oder je nach Möglichkeiten des Hostings einen Snapshot. Verursacht die Website Schaden, schränken Sie die kritische Funktion durch einen angemessenen Wartungsmodus ein, sperren Sie aber nicht die für die Reparatur benötigte Administration. Denken Sie bei einem Onlineshop an neue Bestellungen und externe Callbacks. Löschen Sie weder Logs noch verdächtige Dateien, ohne eine Kopie anzufertigen.
Erfassen Sie Fehler, ohne Details offenzulegen
Die Produktionsumgebung sollte Besuchern keine Stack Traces, Serverpfade oder Datenbankangaben anzeigen. Das WordPress-Debug-Log lässt sich vorübergehend in eine geschützte Datei umleiten und die öffentliche Anzeige deaktivieren. Das Hosting kann ein PHP-Error-Log, ein Webserver-Log und ein Anwendungs-Panel bereitstellen. Gleichen Sie die Zeitangaben ab, da der Server eine andere Zeitzone als die Administration verwenden kann.
Suchen Sie den ersten relevanten fatalen Fehler, den Ausnahmetyp, die Datei, die Zeile und den Call Stack. Spätere Warnungen können lediglich Folgeerscheinungen sein. Derselbe Plugin-Name im Pfad beweist noch keine Schuld; das Plugin könnte eine fehlerhafte Funktion einer anderen Abhängigkeit aufgerufen haben. Schwärzen Sie sensible Ausgaben, bevor Sie sie an den Support senden, behalten Sie aber den technischen Kontext und die Korrelations-ID bei.
- Zeitpunkt und genaue URL
- Erster fataler Fehler im Log
- Datei, Zeile und Call Stack
- Öffentliche Fehleranzeige deaktiviert
Nutzen Sie den Recovery Mode und eine sichere Isolierung
WordPress kann bei bestimmten fatalen Fehlern dem Administrator einen Link zum Recovery Mode senden, der die problematische Komponente für die jeweilige Sitzung vorübergehend deaktiviert. Prüfen Sie die Echtheit der Nachricht und den Zugang zur Administrator-E-Mail-Adresse. Der Recovery Mode dient der Diagnose und Behebung, nicht als Dauerbetrieb mit einem veralteten Plugin.
Ist die Administration nicht erreichbar, kann der Administrator über das Hosting ein bestimmtes Plugin vorübergehend deaktivieren, indem er dessen Verzeichnis umbenennt, oder die CLI verwenden. Dokumentieren Sie den Eingriff und gehen Sie nicht pauschal vor, wenn das Log die konkrete Komponente zeigt. Das Theme sollte vorsichtig gewechselt werden, da das Ersatz-Theme die Templates möglicherweise nicht unterstützt. Nehmen Sie Datenbankänderungen erst nach einem Backup und einem Nachweis vor.
Reproduzieren Sie den Fehler in einer vergleichbaren Umgebung
Stellen Sie eine Kopie auf Staging mit derselben Version von PHP, WordPress, Theme, Plugins und relevanten Daten wieder her. Schalten Sie externe Zahlungen und E-Mails in den Testmodus. Wiederholen Sie das exakte Szenario und ändern Sie dann jeweils eine Variable: Version, Komponente oder Eingabe. Das binäre Deaktivieren von Plugin-Gruppen kann die Eingrenzung beschleunigen, bestätigen Sie das Ergebnis jedoch durch eine konkrete Interaktion.
Hängt ein Fehler vom Datenvolumen oder von Nebenläufigkeit ab, zeigt ihn eine kleine, leere Installation möglicherweise nicht. Verwenden Sie eine anonymisierte, repräsentative Stichprobe sowie Profiling von Speicher oder Abfragen. Eine vorübergehende Erhöhung des Limits kann eine Ressourcenerschöpfung bestätigen, ist aber keine Ursachenbehebung für eine Endlosschleife. Bereiten Sie bei einem Fehler eines Drittanbieters ein minimales Reproduktionsbeispiel und die genauen Versionen vor.
- Gleiche Versionen und Konfiguration
- Eine Änderung pro Test
- Externe Dienste im Testmodus
- Repräsentatives Datenvolumen
Beheben, bereitstellen und die Ursache abschließen
Aktualisieren oder korrigieren Sie die betroffene Komponente oder machen Sie die letzte Änderung über ein vorbereitetes Verfahren rückgängig. Lassen Sie eine ältere verwundbare Version nicht ohne Plan bestehen. Testen Sie vor dem Produktivgang das ursprüngliche Szenario, den Editor, Formulare, die Anmeldung und weitere kritische Abläufe. Deployen Sie außerhalb der Spitzenzeiten und beobachten Sie das Log in Echtzeit, mit der Möglichkeit eines schnellen Rollbacks.
Entfernen Sie nach der Stabilisierung temporäre Debug-Einstellungen, Testkonten und öffentlich zugängliche Diagnosedateien. Dokumentieren Sie die Grundursache, die Erkennung, die Behebung und eine vorbeugende Änderung, zum Beispiel einen Kompatibilitätstest oder das Monitoring eines bestimmten Ereignisses. Betraf der Vorfall die Sicherheit oder Daten, binden Sie die zuständigen Personen entsprechend dem tatsächlichen Umfang ein. Ein Abschluss bedeutet nicht nur, dass die Fehlerseite verschwunden ist.
Häufige Fragen
Sollte ich WP_DEBUG auf einer Produktionswebsite aktivieren?
Bei der Diagnose können Fehler vorübergehend sicher in ein geschütztes Log geschrieben, aber nicht für Besucher angezeigt werden. Einstellung, Speicherort des Logs und Zugriff muss eine technisch verantwortliche Person verwalten, und nach der Behebung sollte die Einstellung zurückgesetzt werden.
Was tun, wenn ein kritischer Fehler auch die Administration blockiert hat?
Verwenden Sie den Recovery Mode, den Dateimanager des Hostings oder die CLI, um die im Log genannte Komponente gezielt zu deaktivieren. Sichern Sie zuerst ein Backup und den aktuellen Zustand. Das wahllose Umbenennen aller Plugins erschwert die Diagnose und beeinträchtigt Funktionen.
Reicht es, die Website aus einem Backup wiederherzustellen?
Eine Wiederherstellung kann den Betrieb schnell wiederherstellen, doch ohne Ursachenermittlung wiederholt sich der Fehler beim nächsten Update oder bei derselben Eingabe. Vergleichen Sie nach der Wiederherstellung die Änderungen, beheben Sie das Grundproblem und überwachen Sie das Ergebnis.