Shopware Plugin inkompatibel
Ein Shopware-Plugin blockiert ein Update, verursacht Fehler im Storefront oder lässt sich nicht mehr aktivieren. Diese Anleitung zeigt, wie Version, Abhängigkeiten, Kompatibilität, Logs und sichere Wiederherstellungswege systematisch geprüft werden.
Plugin kann nicht aktiviert werden, blockiert ein Update oder verursacht Fehler in Administration, Storefront oder Checkout.
Falsche Shopware-Version, veraltete Plugin-Version, Composer-Konflikt oder nicht angepasster Theme- beziehungsweise Administration-Code.
Nicht pauschal im Liveshop deaktivieren. Erst Auswirkungen, Datenhaltung und Wiederaktivierung prüfen.
1. Fehlerbild genau eingrenzen
- Blockiert das Plugin ein Shopware-Update?
- Lässt es sich nicht installieren oder aktivieren?
- Ist nur die Storefront betroffen?
- Funktioniert die Administration nicht mehr?
- Tritt der Fehler nur im Checkout auf?
- Trat der Fehler nach einem Plugin- oder Shopware-Update auf?
- Ist das Plugin über Composer oder unter custom/plugins installiert?
Fehlermeldung, Shopware-Version, Plugin-Version und letzter funktionierender Zustand müssen dokumentiert werden.
2. Backup und Testsystem vorbereiten
- Datenbank-Backup vorhanden
- Datei-Backup vorhanden
- Plugin-Dateien und Konfiguration gesichert
- Aktives Theme dokumentiert
- Testsystem oder Staging verfügbar
- Wiederherstellungsweg bekannt
Eine Deinstallation mit Datenlöschung kann eigene Tabellen, Custom Fields und geschäftskritische Konfigurationen unwiederbringlich entfernen.
3. Installierte Plugins und Status anzeigen
bin/console plugin:refresh
bin/console plugin:list/usr/bin/php bin/console plugin:refresh
/usr/bin/php bin/console plugin:listRelevant sind technischer Plugin-Name, installierte Version, aktiver Status und mögliche Upgrade-Hinweise.
4. Kompatibilität zur Shopware-Version prüfen
Vor einem Shopware-Update muss geprüft werden, ob für jede aktive Erweiterung eine passende Version verfügbar ist.
- Aktuelle Shopware-Version ermitteln
- Zielversion festlegen
- Installierte Plugin-Version dokumentieren
- Herstellerfreigabe für die Zielversion prüfen
- Verfügbare Plugin-Aktualisierung prüfen
- Individuelle Plugins separat testen
- Theme-Kompatibilität berücksichtigen
Ein großzügiger Versionsbereich beweist nicht, dass Administration, Storefront und Migrationen tatsächlich funktionieren.
5. Plugin kontrolliert aktualisieren
bin/console plugin:update PLUGIN_NAME/usr/bin/php bin/console plugin:update PLUGIN_NAMEPLUGIN_NAME durch den technischen Namen aus plugin:list ersetzen.
bin/console cache:clear
bin/console cache:warmup6. Composer-Abhängigkeiten prüfen
composer validate
composer why-not shopware/core ZIELVERSION
composer why PAKETNAMEDadurch können zahlreiche Paketversionen gleichzeitig wechseln. Konflikte zuerst gezielt anhand der Composer-Ausgabe auflösen.
7. Aktivierungsfehler analysieren
bin/console plugin:activate PLUGIN_NAME --clear-cache| Fehlerhinweis | Mögliche Ursache |
|---|---|
| Class not found | Abhängigkeit fehlt oder Autoloader unvollständig |
| Service not found | DI-Konfiguration nicht kompatibel |
| SQLSTATE | Plugin-Migration oder Datenbankschema fehlerhaft |
| Method not found | Veraltete Shopware-API |
| Compilation failed | Theme-, Twig-, SCSS- oder Administration-Code fehlerhaft |
8. Plugin nur kontrolliert deaktivieren
bin/console plugin:deactivate PLUGIN_NAME --clear-cacheBei einer Deaktivierung bleibt das Plugin installiert. Eine Deinstallation kann Daten und Konfigurationen verändern oder löschen.
Die dauerhafte Entfernung aller Plugin-Daten ist irreversibel und gehört nicht in eine normale Kompatibilitätsprüfung.
9. Theme- und Storefront-Konflikte prüfen
- Fehler tritt nur bei aktivem Theme auf
- Twig-Vererbung verweist auf entfernte Blöcke
- SCSS verwendet nicht mehr vorhandene Variablen
- Storefront-JavaScript nutzt veraltete APIs
- Theme-Kompilierung bricht ab
bin/console theme:compile10. Shopware- und Server-Logs auswerten
ls -lah var/log/
tail -n 250 var/log/prod-*.log
grep -RiE "plugin|extension|class not found|service not found|migration|exception|fatal" var/log/ | tail -n 300Zusätzlich können PHP-, Webserver- und Browser-Logs relevant sein.
11. Wiederherstellung und Ersatz planen
| Situation | Sinnvoller Weg |
|---|---|
| Kompatibles Update verfügbar | Im Testsystem aktualisieren und vollständig prüfen |
| Hersteller plant spätere Freigabe | Shopware-Update verschieben oder Zwischenlösung planen |
| Plugin wird nicht mehr gepflegt | Ersatz, individuelle Anpassung oder Funktionsverzicht bewerten |
| Plugin blockiert Liveshop | Kontrollierte Deaktivierung mit Backup und Funktionsprüfung |
| Migration teilweise gelaufen | Datenbankzustand fachlich analysieren |
Plugin-Code, Shopware-Version und Datenbankschema müssen zusammenpassen.
12. Abschlusskontrolle
- Shopware- und Plugin-Version sind dokumentiert.
- Backup und Testsystem sind vorhanden.
- Kompatibilität zur Zielversion wurde geprüft.
- Plugin-Update wurde im Testsystem ausgeführt.
- Composer-Abhängigkeiten sind aufgelöst.
- Aktivierung läuft ohne Exception.
- Cache wurde neu aufgebaut.
- Theme-Kompilierung läuft erfolgreich.
- Administration und Storefront funktionieren.
- Checkout, Zahlungsarten und Versand wurden geprüft.
- Logs enthalten keine neuen kritischen Fehler.
Die Prüfung ist abgeschlossen, wenn das Plugin mit der vorgesehenen Shopware-Version in allen betroffenen Geschäftsprozessen getestet wurde.
Häufige Fragen
Wie erkenne ich, ob ein Plugin kompatibel ist?
Entscheidend sind Herstellerfreigabe, Plugin-Version, Shopware-Updateprüfung und ein vollständiger Test.
Muss ich vor jedem Shopware-Update alle Plugins deaktivieren?
Nicht bei jedem Update pauschal. Für bestimmte Hauptversionswechsel kann Shopware dies ausdrücklich verlangen.
Kann ich ein inkompatibles Plugin einfach deaktivieren?
Nur nach Prüfung der Auswirkungen auf Zahlungsarten, Versand, Checkout und Integrationen.
Was ist der Unterschied zwischen deaktivieren und deinstallieren?
Beim Deaktivieren bleibt die Erweiterung installiert. Eine Deinstallation kann Daten und Konfigurationen verändern oder löschen.
Warum funktioniert das Plugin nach dem Update nicht mehr?
Mögliche Ursachen sind geänderte Shopware-APIs, PHP-Anforderungen, Administration-Technik, Theme-Vererbung oder Migrationen.
Verwandte Shopware-Anleitungen
Das Shopware Plugin bleibt inkompatibel?
Ich prüfe Plugin-Version, Shopware-Kompatibilität, Composer-Abhängigkeiten, Theme, Migrationen und Logs direkt in der bestehenden Shopware-Installation.
Technische Prüfung anfragen