Shopware 6 Bilder fehlen: So löst du das Problem

26. Juli 2024

Hast du gerade ein Update deines Shopware 6 Online-Shops durchgeführt oder zwischen verschiedenen Umgebungen gewechselt und plötzlich sind alle Bilder verschwunden? Keine Sorge, du bist nicht allein mit diesem Problem. Wenn in Shopware 6 Bilder fehlen haben wir die Lösung für dich: In diesem Artikel zeigen wir dir Schritt für Schritt, wie du fehlende Bilder in Shopware 6 wieder sichtbar machst und was die häufigsten Ursachen dafür sind.

Warum plötzlich in Shopware 6 Bilder fehlen?

Es gibt verschiedene Gründe, warum Bilder in deinem Shopware 6 Shop plötzlich nicht mehr angezeigt werden:

  1. Update auf eine neue Shopware-Version
  2. Wechsel zwischen Entwicklungs-, Staging- und Produktionsumgebungen
  3. Unterschiedliche Einstellungen für die Medien-Pfadstrategie

Besonders häufig tritt das Problem auf, wenn du deinen Shop von einer Umgebung in eine andere überträgst oder ein größeres Update durchführst. Lass uns gemeinsam die Lösungen durchgehen, mit denen du die fehlenden Bilder in Shopware 6 wiederherstellen kannst.

Shopware 6 Bilder fehlen wegen falscher Medien-Pfadstrategie

Bevor wir zur Lösung kommen, ist es wichtig zu verstehen, wie Shopware 6 mit Medien-Pfaden umgeht. Es gibt drei vordefinierte Strategien:

  1. Id-Strategie
  2. Filename-Strategie
  3. PhysicalFilename-Strategie

Je nachdem, welche Strategie verwendet wird, können die Pfade zu denselben Bildern in verschiedenen Umgebungen unterschiedlich sein. Das führt dazu, dass Bilder, die in einer Umgebung funktionieren, in einer anderen plötzlich nicht mehr angezeigt werden.

Lösung 1: SHOPWARE_CDN_STRATEGY_DEFAULT setzen

Der erste Schritt zur Behebung fehlender Bilder in Shopware 6 ist das Setzen der richtigen Medien-Pfadstrategie. Füge dazu folgende Zeile in deine .env-Datei ein:

SHOPWARE_CDN_STRATEGY_DEFAULT="id"

Alternativ kannst du auch die physical_filename-Strategie oder die filename-Strategie verwenden:

SHOPWARE_CDN_STRATEGY_DEFAULT="physical_filename"
SHOPWARE_CDN_STRATEGY_DEFAULT="filename"

Wichtig: Stelle sicher, dass du diese Einstellung in allen deinen Umgebungen (lokal, Staging, Produktion) gleich setzt.

Lösung 2: Medien-Pfade aktualisieren mit dem force Flag

Wenn du die Strategie angepasst hast und die Bilder immer noch fehlen, kommt der nächste Trick ins Spiel. Führe folgenden Befehl in der Konsole aus:

bin/console media:update-path --force

Dieser Befehl aktualisiert alle Medien-Pfade in deiner Shopware 6 Installation und erzwingt die Neugenerierung der Pfade entsprechend der eingestellten Strategie. Wichtig ist hierbei das --force Flag. Die Information zu der Flag fehlt leider auch in der Shopware 6 Dokumentation (Stand 24.07.2024).

Lösung 3: Thumbnails neu generieren

In manchen Fällen werden die Bilder nicht angezeigt, weil die Thumbnails fehlen. Um dieses Problem zu beheben, kannst du die Thumbnails neu generieren lassen:

bin/console media:generate-thumbnails

Nach der Ausführung dieses Befehls sollten deine Bilder wieder korrekt angezeigt werden.

Spezialfall: Fehlende Icons und Kategorie-Bilder

Sollten nach den vorherigen Schritten immer noch Bilder wie Icons von Zahlungsarten, Versandarten oder Kategorie-Bilder fehlen, gibt es einen zusätzlichen Trick:

  1. Lade ein Originalbild des fehlenden Typs herunter (z.B. ein Zahlungsart-Icon)
  2. Benenne es lokal um
  3. Ersetze das fehlende Bild im Shop mit dem umbenannten Bild

Wenn du diesen Prozess für einen Bildtyp durchgeführt hast, sollten alle Bilder desselben Typs wieder angezeigt werden.

Fazit: Shopware 6 Bilder fehlen? Kein Problem mehr!

Wie du siehst, gibt es verschiedene Wege, um das Problem fehlender Bilder in Shopware 6 zu lösen. Mit den richtigen Einstellungen und Befehlen kannst du schnell dafür sorgen, dass dein Shop wieder in vollem Glanz erstrahlt.

Denk daran: Wenn du zwischen Umgebungen wechselst oder Updates durchführst, überprüfe immer deine Medien-Pfadstrategie und aktualisiere bei Bedarf deine Medien-Pfade. So stellst du sicher, dass deine Kund:innen immer alle Bilder sehen können und dein Shop optimal funktioniert.

Hast du weitere Fragen zum Thema „Shopware 6 Bilder fehlen“ oder brauchst du Unterstützung bei anderen Shopware-Themen? Dann zögere nicht uns zu kontaktieren! Wir helfen dir gern bei der Wartung von Shopware 6 oder entwickeln dir individuelle Shopware 6 Plugins.