WordPress-500-Fehler nach der Aktualisierung eines Plugins

Was dieser Fehler bedeutet und wie du ihn erkennst

• Die Website funktionierte, bevor ein Plugin aktualisiert wurde. Danach lieferten das Frontend, das WordPress-Dashboard oder beide HTTP-500-Fehler.
• Der Fehler kann nach einem manuellen oder automatischen Plugin-Update auftreten.
• Die öffentliche Website kann geladen werden, während /wp-admin/ fehlschlägt. Alternativ können nur Seiten und Requests fehlschlagen, die das aktualisierte Plugin verwenden.
• Der Browser zeigt möglicherweise einen allgemeinen Fehler „500 Internal Server Error“, eine leere Seite oder eine WordPress-Meldung über einen kritischen Fehler anstelle der eigentlichen Ursache.
• Durch das Umbenennen des Verzeichnisses des kürzlich aktualisierten Plugins kann die Website wieder geladen werden.
• Das Server- oder WordPress-Debug-Log kann einen PHP-Fatal-Error, einen Parse-Error, einen Fehler wegen einer fehlenden Datei oder eine Meldung enthalten, in der das aktualisierte Plugin genannt wird.

Hauptursachen nach Wahrscheinlichkeit

1. PHP-Inkompatibilität: Die neue Plugin-Version benötigt möglicherweise eine PHP-Funktion oder -Version, die der Server nicht bereitstellt.
2. Konflikt mit Plugin, Theme oder WordPress: Das Update kann sich schlecht mit einer anderen Erweiterung, dem aktiven Theme oder der installierten WordPress-Core-Version vertragen. Doppelte Funktions- oder Klassendeklarationen sind häufige Hinweise.
3. Unvollständiges oder beschädigtes Update: Ein Timeout, eine unterbrochene Verbindung oder eine fehlgeschlagene Dateiübertragung kann dazu führen, dass Plugin-Dateien fehlen oder beschädigt sind.
4. Plugin-Regression: Die neue Version kann einen Fehler enthalten, der die Konfiguration dieser Website beeinträchtigt, selbst wenn die angegebenen PHP- und WordPress-Anforderungen erfüllt sind.
5. Separates oder umfassenderes Hosting-Problem: Wenn das Deaktivieren des aktualisierten Plugins nichts ändert, kann die 500-Antwort mit einer anderen kürzlich vorgenommenen Änderung, der PHP-Konfiguration, Berechtigungen, Ressourcenlimits oder einem serverseitigen Fehler zusammenhängen.

So behebst du den Fehler

1. Zeitpunkt und Umfang bestätigen

Ermitteln Sie, welches Plugin unmittelbar vor dem Auftreten des Fehlers aktualisiert wurde. Wenn mehrere Plugins gleichzeitig aktualisiert wurden, notieren Sie alle. Prüfen Sie die öffentliche Website, /wp-admin/ und alle betroffenen pluginspezifischen Funktionen. Vermeiden Sie nicht zusammenhängende Updates, bis die vermutete Ursache getestet wurde.

2. Das aktualisierte Plugin ohne Dashboard deaktivieren

Bevor Sie Dateien ändern, stellen Sie sicher, dass Sie über SFTP oder den Dateimanager des Hosters autorisierten Zugriff auf die Website haben und, wenn möglich, ein aktuelles Backup besitzen. Öffnen Sie wp-content/plugins/ und benennen Sie das Verzeichnis des verdächtigen Plugins um, indem Sie beispielsweise das Suffix -disabled hinzufügen.

Laden Sie das Frontend und /wp-admin/ neu:

• Wenn die Website wieder funktioniert, lassen Sie das Plugin deaktiviert, während Sie die Logs prüfen und ein Rollback oder eine Kompatibilitätslösung auswählen.
• Wenn sich nichts ändert, stellen Sie den ursprünglichen Verzeichnisnamen wieder her und testen Sie das nächste Plugin, das zur gleichen Zeit aktualisiert wurde.
• Wenn der Fehler bestehen bleibt, nachdem alle kürzlich aktualisierten Plugins deaktiviert wurden, prüfen Sie die Server- und PHP-Logs und untersuchen Sie andere kürzlich vorgenommene Änderungen am Hosting oder an der Konfiguration.

Das Umbenennen eines Verzeichnisses verändert, welche Plugins WordPress lädt. Verwenden Sie es daher nicht als Ersatz dafür, das zugrunde liegende Problem zu ermitteln und zu beheben.

3. Den zugrunde liegenden PHP-Fehler erfassen

Eine 500-Antwort ist nur das äußere Symptom. Wenn Sie berechtigt sind, wp-config.php zu bearbeiten, aktivieren Sie das Logging vorübergehend oberhalb der Zeile, die angibt, dass die Bearbeitung beendet wurde:

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

Lassen Sie das verdächtige Plugin weiterhin deaktiviert und sichern Sie das aktuelle Log, falls erforderlich. Aktivieren Sie das Plugin erst wieder, wenn Sie bereit sind, den Fehler zu reproduzieren. Reproduzieren Sie ihn dann einmal und prüfen Sie wp-content/debug.log sowie das PHP- oder Server-Fehlerprotokoll im Hosting-Panel. Suchen Sie nach dem Plugin-Namen, einer Meldung zur PHP-Version, einer fehlenden Datei, einem Parse-Error, Cannot redeclare function oder Cannot declare class.

Debug-Logging kann sensible Implementierungsdetails aufzeichnen und sollte nur vorübergehend aktiviert sein. Deaktivieren Sie die Einstellungen nach dem Test, insbesondere auf einer öffentlich erreichbaren Produktionswebsite, und entfernen oder sichern Sie offengelegte Logdaten gemäß den Verfahren Ihres Hosters.

4. Die Logmeldung der wahrscheinlichen Ursache zuordnen

• Eine nicht unterstützte PHP-Funktion oder eine erforderliche PHP-Version weist auf ein PHP-Kompatibilitätsproblem hin.
• Eine Meldung, in der zwei Erweiterungen oder ein Theme zusammen mit Cannot redeclare function oder Cannot declare class genannt werden, weist auf einen Kompatibilitätskonflikt hin.
• Eine fehlende Datei, ein Parse-Error oder ein Fehler im Verzeichnis des kürzlich aktualisierten Plugins deutet auf ein unvollständiges oder beschädigtes Update hin.
• Ein Fehler, in dem der WordPress-Core oder eine andere Erweiterung genannt wird, kann auf ein umfassenderes Kompatibilitätsproblem hinweisen, das durch das Update sichtbar wurde.
• Wenn im Log weder das Plugin noch eine zugehörige Komponente genannt wird, prüfen Sie die Fehler auf Hosting-Ebene, bevor Sie davon ausgehen, dass das Update verantwortlich ist.

5. Auf die zuletzt bekannte funktionierende Plugin-Version zurücksetzen

Wenn die Website schnell wiederhergestellt werden muss, sichern Sie eine Kopie der aktuellen Plugin-Dateien und verwenden Sie ein verifiziertes Backup oder ein älteres Paket aus der etablierten Bezugsquelle des Plugins. Laden Sie es über SFTP oder den Dateimanager des Hosters hoch beziehungsweise stellen Sie es darüber wieder her. Testen Sie anschließend die Website, bevor Sie das Plugin wieder aktivieren.

Überschreiben Sie nicht die einzige Kopie eines funktionierenden Backups. Lassen Sie automatische Updates für dieses Plugin deaktiviert oder prüfen Sie sie manuell, bis die Ursache verstanden und eine kompatible Version verfügbar ist.

6. PHP- und WordPress-Anforderungen prüfen

Vergleichen Sie die angegebenen Mindestversionen für PHP und WordPress der aktualisierten Plugin-Version mit den tatsächlich auf der Website verwendeten Versionen. Wenn das Dashboard verfügbar ist, werden PHP-Informationen üblicherweise unter Werkzeuge → Website-Zustand → Info angezeigt. Auch das Hosting-Control-Panel kann die aktive PHP-Version anzeigen.

Wenn PHP oder WordPress unter der Plugin-Anforderung liegt, erstellen Sie ein Backup und bestätigen Sie vor dem Upgrade die Kompatibilität mit dem Theme, anderen Plugins und der Hosting-Umgebung. Wenn der Hoster PHP verwaltet, fragen Sie ihn nach dem unterstützten Upgrade-Pfad. Ändern Sie die PHP-Version der Produktionsumgebung nicht unüberlegt, da dies den restlichen Teil der Website beeinträchtigen kann.

7. Einen bestätigten Konflikt oder eine Regression eskalieren

Lassen Sie das inkompatible Update deaktiviert oder stellen Sie die zuletzt bekannte funktionierende Version wieder her. Melden Sie den genauen Fatal-Error, die Plugin-Versionen, die PHP-Version, die WordPress-Version und die Schritte zur Reproduktion an die zuständigen Plugin- oder Theme-Entwickler. Vermeiden Sie dauerhafte Änderungen an Plugin-Dateien: Ein künftiges Update kann diese Änderungen überschreiben und die Website in einen nicht unterstützten Zustand versetzen.

Vorbeugung und Überprüfung der Lösung

• Erstellen und überprüfen Sie vor Plugin-Updates ein Backup sowohl der Datenbank als auch der Website-Dateien.
• Aktualisieren Sie Plugins nach Möglichkeit einzeln, damit sich ein Fehler einer bestimmten Änderung zuordnen lässt.
• Testen Sie umfangreiche Änderungen an Plugins, WordPress und PHP zunächst auf einer Staging-Kopie, bevor Sie sie in der Produktionsumgebung anwenden.
• Halten Sie PHP und WordPress innerhalb der von den Plugins und dem Theme angegebenen unterstützten Versionen.
• Testen Sie nach jedem Update die öffentliche Website, /wp-admin/, die Anmeldung, Formulare und die vom aktualisierten Plugin bereitgestellten Funktionen.
• Prüfen Sie automatische Updates für geschäftskritische Plugins oder Plugins, bei denen es bereits Kompatibilitätsprobleme gab.
• Halten Sie eine dokumentierte, zuletzt bekannte funktionierende Plugin-Version und eine Wiederherstellungsmethode bereit.
• Deaktivieren Sie nach der Fehlerbehebung vorübergehend aktivierte Debug-Anzeige- und Logging-Einstellungen und schützen oder entfernen Sie Logs mit internen Fehlerdetails.

Häufig gestellte Fragen