Das Problem: Bildertausch führt zu Duplikaten oder Altlasten
Wer JTL-Wawi in Kombination mit Shopware 6 betreibt, kennt folgendes Szenario: Ein Artikelbild muss in der Wawi ausgetauscht werden. Man löscht oder ersetzt das Bild im Artikelstamm und führt einen Abgleich durch. Doch im Shopware-Mediapool erscheint das neue Bild plötzlich zusätzlich, oder das alte Bild verbleibt als „Geisterbild“ ohne Artikelzuordnung auf dem Server.
Der Grund liegt im Media-Management von Shopware 6: Mediendateien werden über eindeutige UUIDs verwaltet. Wird bei einem Tausch in der Wawi nicht in der richtigen Reihenfolge abgeglichen, verliert der JTL-Connector das Mappings und legt eine neue UUID an, statt die bestehende Datei zu ersetzen.
Schritt 1: Verwaiste Server-Dateien & Datenbank bereinigen
Shopware 6 bietet Konsolenbefehle (CLI), um verwaiste Mediendateien und Thumbnails physisch von der Festplatte zu löschen. Der häufig genutzte Befehl media:delete-unused bereinigt nur Datenbankeinträge. Erst die Kombination mit media:clean-unused-files löscht auch die physischen Leichen aus public/media/.
# 1. In das Shopware-Hauptverzeichnis wechseln
cd /pfad/zu/ihrem/shopware/root
# 2. Datenbank-Referenzen für ungenutzte Medien entfernen
php bin/console media:delete-unused
# 3. Physische Dateien & Thumbnails vom Server löschen
php bin/console media:clean-unused-files
# 4. Shopware-Cache leeren
php bin/console cache:clear
Schritt 2: Das Connector-Mapping zurücksetzen (SQL & Wawi-Neuübertragung)
Möchten Sie den Bildbestand für Ihren gesamten Katalog einmal komplett frisch aufbauen, sollten Sie niemals pauschal die gesamte Datenbank oder Connector-Tabelle leeren, da sonst Kunden- und Bestellzuordnungen verloren gehen. Zielgerichtet löschen Sie nur die Medien-Mappings und Produktschlüssel:
-- 1. Hauptbild-Zuordnungen an Produkten zurücksetzen
UPDATE product SET cover_id = NULL;
-- 2. Produkt-Medien-Verknüpfungen im Shop leeren
DELETE FROM product_media;
-- 3. Nur die Bild-Mappings im JTL-Connector löschen
DELETE FROM jtl_connector_link WHERE endpoint = 'image' OR endpoint = 'product_image';
Stoßen Sie direkt im Anschluss in JTL-Wawi einen vollständigen Bild-Abgleich an. Der Connector überträgt die Bilder sauber neu und baut die Verknüpfungen fehlerfrei auf.
Empfohlenes Vorgehen bei künftigen Bildänderungen
Um das Entstehen neuer Duplikate im Arbeitsalltag zu verhindern, halten Sie beim Ersetzen von Bildern in JTL-Wawi stets diese Reihenfolge ein:
- Altes Bild in Wawi löschen und Artikel speichern.
- Abgleich durchführen: Der Connector entfernt das Bild kontrolliert aus Shopware.
- Neues Bild hochladen und erneut abgleichen.