Einen WordPress-Fehler debuggen lernen

Eine weiße Seite oder eine Antwort 500 nennt für sich allein nicht die Ursache: Der Fehler kann aus PHP, WordPress, dem Webserver oder einer Abhängigkeit stammen. Beginnen Sie mit dem Protokoll zur Anfrage und zur genauen Uhrzeit des Fehlers, ohne ihn schon einem Plugin oder einer kürzlichen Änderung zuzuschreiben.

Führen Sie den Test am besten in einer Staging-Kopie durch. Wenn Sie ihn in der Produktion nachstellen müssen, lassen Sie display_errors deaktiviert und schreiben Sie die Fehler in ein privates Protokoll außerhalb von public_html, wie in der Anleitung Fehler in WordPress debuggen beschrieben.

Wenn WordPress die Meldung über einen kritischen Fehler zeigt, prüfen Sie zuerst das E-Mail-Postfach des Administratorkontos. Seit WordPress 5.2 können Sie über den Link zum Wiederherstellungsmodus zugreifen, während das problematische Plugin oder Theme für diese Sitzung pausiert ist.

Führen Sie nur die fehlerhafte Aktion aus und sehen Sie sofort ins Protokoll. In diesem Beispiel erscheint folgender fataler Fehler:

Fatal error: require(): Failed opening required 
'/home/user/public_html/wp-content/plugins/woocommerce/src/Packages.php' 
(include_path='.:/opt/alt/php74/usr/share/pear') 
in /home/user/public_html/wp-content/plugins/woocommerce/woocommerce.php on line 25

Die Meldung beweist, dass require diese Datei nicht öffnen konnte:

public_html/wp-content/plugins/woocommerce/src/Packages.php

und dass der Aufruf aus Zeile 25 dieser Datei kam:

public_html/wp-content/plugins/woocommerce/woocommerce.php

Damit liegt der Fehler beim Laden von WooCommerce, aber das beweist für sich allein weder, dass das Plugin beschädigt ist, noch warum die Datei nicht geöffnet werden konnte. Prüfen Sie auch die Warnung vor Failed opening required, die meist angibt, ob die Datei nicht existiert, nicht lesbar ist oder durch eine Pfadbeschränkung blockiert wird. Prüfen Sie, ob sie existiert, Groß- und Kleinschreibung, Rechte, Eigentümer und ob sie zur installierten Version passt.

Wenn die Datei tatsächlich fehlt und der Fehler während eines Updates auftrat, ist eine unvollständige Installation eine Vermutung, die zu den Belegen passt. Um vorübergehend wieder Zugang zu erhalten, nutzen Sie zuerst den Wiederherstellungsmodus oder benennen Sie wp-content/plugins/woocommerce um; löschen Sie das Verzeichnis nicht, bevor Sie eine Kopie für die Analyse gesichert haben.

Danach können Sie dieselbe oder eine kompatible Version aus einer offiziellen Quelle neu installieren. Stellen Sie das Verzeichnis nur dann aus einem Backup wieder her, wenn das Backup älter als der Fehler ist, als sauber gilt und zum aktuellen Stand der Datenbank passt.

Den Shop wiederherstellen und den gesamten Bestellablauf prüfen

Der Stacktrace ist ein historisches Beispiel: Der Pfad php74 ist keine Empfehlung, PHP 7.4 zu verwenden. Nutzen Sie die kompatible und gepflegte Version, die zu Ihrer aktuellen WooCommerce-Version passt.

Solange WooCommerce pausiert ist, können dem Shop Kauffunktionen fehlen. Bewahren Sie aktuelle Bestellungen und spielen Sie keine alte Datenbank ein, nur um eine Plugin-Datei zurückzuholen. Prüfen Sie nach der Reparatur der Dateien in einer Testumgebung Katalog, Warenkorb, Kaufabschluss und Zahlungsbenachrichtigung. Wenn Sie eine Version installieren, die die Datenbank migriert, planen Sie auch die Kompatibilität eines Rollbacks ein; einen alten Ordner später zurückzukopieren macht diese Migration nicht rückgängig.