Schlägt ein Pickware-Update in der Shopware Admin fehl, liegt es meist an einem veralteten Cache oder an Datenbankmigrationen, die nicht gelaufen sind. Mit den folgenden Schritten behebst du die häufigsten Fehler selbst. Hast du Pickware per Composer installiert, findest du die passende Fehlerbehebung in Wie installiere ich Pickware per Composer?.
Achtung: Lege vor dem Update ein Backup an. Läuft das Update nicht durch, spielst du dieses Backup wieder ein, bevor du es erneut versuchst.
Fehler direkt nach dem Update: Cache löschen
Treten direkt nach dem Update Fehler wie ArgumentCountError, Too few arguments to function …::__construct() oder Class … not found auf, mischt der Cache alte und neue Teile der Erweiterung. So gehst du vor:
Spiele dein Backup ein.
Lösche den Ordner
var/cachedeines Shops vollständig. Der Befehlbin/console cache:clearreicht hier nicht, weil er Reste zurücklässt. Alternativ benennst du den Ordnerprod_…im Cache um.Rufe deinen Shop bzw. die Shopware Admin einmal auf, damit der Cache neu aufgebaut wird.
Starte das Update erneut.
Erscheint ein ArgumentCountError nur einmal direkt nach dem Update, ist das ein Nebeneffekt des alten Caches. Sobald der Cache neu aufgebaut ist, verschwindet er.
Fehler wegen fehlender Datenbankmigrationen
Meldungen wie Table … doesn't exist, Unknown column … oder ein Fehler 500 beim Deaktivieren zeigen, dass Datenbankmigrationen nicht gelaufen sind. Führe in diesem Fall einen der beiden Befehle aus und leere danach den Cache:
bin/console system:update:finish
bin/console database:migrate --all
bin/console cache:clear
Hinweis: Beim reinen Aktivieren einer Erweiterung führt Shopware keine Migrationen aus. Aktualisiere die Erweiterung deshalb erneut, statt sie nur zu aktivieren.
Staging-Umgebung aus einem Datenbank-Dump des Live-Shops
Hast du deine Staging-Umgebung aus einem Datenbank-Dump deines Live-Shops aufgebaut, passt der Stand der Migrationen oft nicht zur Datenbank. Führe auf der Staging-Umgebung bin/console database:migrate --all aus. Erscheinen Fehler mit Fremdschlüsseln wie Can't DROP FOREIGN KEY …, wende dich an den Support und schicke die Ausgabe von bin/console database:migration:status mit.
Tabelle existiert bereits
Meldet das Update Table … already exists, obwohl die Tabelle korrekt angelegt ist, kann der Support die betroffene Migration überspringen lassen. Wende dich in diesem Fall an den Support, statt selbst Änderungen an der Datenbank vorzunehmen.
Pickware aktuell halten
Viele gemeldete Fehler sind in neueren Pickware Versionen bereits behoben. Bringe deine Pickware Erweiterungen deshalb auf die aktuelle Version, bevor du nach anderen Ursachen suchst.
Was der Support von dir braucht
Hilft keiner der Schritte, wende dich an den Support. Damit wir dir schnell helfen können, schicke uns:
Die vollständige Fehlermeldung
Deine Shopware Version und die Version der Pickware Erweiterung
Einen Zugang zur Shopware Admin sowie einen SFTP- bzw. SSH-Zugang
Weitere Tipps findest du in Was kann ich machen, damit meine Supportanfrage schneller beantwortet wird?.