Shopware 6 Cache leeren: Anleitung für Admin, Konsole und typische Probleme

Stellen Sie sich vor, Sie ändern im Schaufenster Ihres Ladens ein Schild. Aber Passant:innen sehen weiterhin das alte, weil jemand ein Foto davon aufgehängt hat und alle auf das Foto schauen. Genau so ähnlich funktioniert ein Cache. Er merkt sich Seiten, damit der Shop schneller wird. Ändern Sie etwas, sieht man manchmal trotzdem noch das alte Bild.

Deshalb lautet eine der häufigsten Fragen rund um Shopware: Wie kann ich den Cache leeren? Die gute Nachricht: Es geht mit wenigen Klicks. Die weniger gute: Wer den Cache falsch oder zur falschen Zeit leert, kann seinen Shop kurzzeitig langsam machen oder sogar Fehler provozieren.

In diesem Beitrag lesen Sie, was der Cache in Shopware 6 macht, wie Sie ihn im Admin und in der Konsole leeren, wann Sie das tun sollten und wann nicht, was „aufwärmen" und „Indizes" bedeuten und wie Sie typische Probleme lösen.

Alles ist so erklärt, dass Sie es ohne Technikwissen verstehen. Wo es technisch wird, sagen wir es klar.

Was ist der Cache in Shopware 6?

Ein Cache ist ein Zwischenspeicher. Statt jede Seite bei jedem Besuch neu zu berechnen, merkt sich Shopware das Ergebnis und liefert es beim nächsten Besuch sofort aus. Das spart Rechenzeit und macht den Shop schnell.

Man kann es mit einer Bäckerei vergleichen. Wenn jede Kundin ein Brötchen bestellt und es erst gebacken werden muss, dauert es lang. Liegen schon fertige Brötchen in der Theke, geht es blitzschnell.

In Shopware 6 gibt es mehrere Arten von Cache:

• HTTP-Cache: speichert fertige Seiten für Besucher:innen. Er ist der wichtigste für die Geschwindigkeit.

• Objekt-Cache: merkt sich Daten aus der Datenbank, zum Beispiel Einstellungen.

• Twig-Cache: speichert die fertig übersetzten Vorlagen der Seite.

• Theme-Cache: enthält das fertig gebaute Aussehen, also Farben, Schriften und Layout.

• Browser-Cache: liegt nicht bei Ihnen, sondern im Browser der Besucher:innen.

Wenn Sie den Shop schneller machen wollen, hilft ein guter Cache enorm. Mehr dazu lesen Sie im Beitrag Shopware Performance optimieren.

Wann sollten Sie den Cache leeren?

Meistens müssen Sie den Cache nicht von Hand leeren. Shopware merkt selbst, wenn sich etwas ändert, und erneuert die betroffenen Teile. Trotzdem gibt es Situationen, in denen ein manuelles Leeren sinnvoll ist:

• Sie haben ein Plugin installiert, aktualisiert oder deaktiviert.

• Sie haben das Theme geändert, zum Beispiel Farben, Schriften oder Layout.

• Sie haben Einstellungen geändert und im Shop sieht man noch den alten Stand.

• Sie haben ein Update von Shopware durchgeführt.

• Sie haben Inhalte geändert und die Änderung erscheint nicht auf der Seite.

• Der Shop zeigt seltsame Fehler, die nach einer Änderung auftraten.

Wann Sie den Cache besser nicht leeren sollten:

• Mitten im Hochbetrieb, zum Beispiel bei einer Aktion oder am Black Friday. Danach muss der Shop jede Seite neu berechnen und wird kurz langsam.

• Ohne Grund und ständig. Ein leerer Cache bedeutet langsamere Seiten, bis er wieder gefüllt ist.

Mehr zu Updates lesen Sie im Beitrag Shopware 6 Update durchführen.

Cache leeren im Admin: Der einfachste Weg

Im Admin von Shopware 6 geht das ohne Programmierung. So finden Sie die Funktion:

1. Melden Sie sich im Admin an.

2. Öffnen Sie die Einstellungen.

3. Gehen Sie zum Bereich System.

4. Wählen Sie Caches & Indizes.

Dort gibt es mehrere Schaltflächen:

• Caches leeren: löscht die Zwischenspeicher. Danach werden sie nach und nach neu gefüllt.

• Caches leeren & aufwärmen: löscht die Zwischenspeicher und baut sie sofort wieder auf. Das ist meist die bessere Wahl, weil der Shop danach nicht langsam startet.

• Indizes neu aufbauen: berechnet Such- und Listendaten neu. Mehr dazu weiter unten.

Unser Tipp: Nutzen Sie im Alltag „Caches leeren & aufwärmen". Bei großen Shops kann das einige Minuten dauern. Lassen Sie die Seite offen, bis der Vorgang fertig ist.

Wichtig: Diese Funktion leert Caches auf dem Server. Die Zwischenspeicher im Browser der Besucher:innen sind davon nicht betroffen. Dazu mehr im nächsten Abschnitt.

Cache leeren per Konsole

Wer Zugriff auf den Server hat, kann den Cache auch per Befehl leeren. Das ist schneller und zuverlässiger, besonders bei großen Shops oder wenn der Admin nicht mehr erreichbar ist. Die Befehle führen Sie im Hauptordner Ihres Shops aus.

Die wichtigsten Befehle:

• `bin/console cache:clear` leert den Cache.

• `bin/console cache:warmup` baut ihn wieder auf.

• `bin/console theme:compile` baut das Theme neu, nötig nach Änderungen an Aussehen und Layout.

• `bin/console dal:refresh:index` baut die Indizes neu auf.

Je nach Einrichtung des Servers müssen Sie die Befehle unter dem richtigen Benutzer ausführen, also dem gleichen Benutzer, unter dem der Webserver läuft. Sonst entstehen Dateien mit falschen Rechten, und es kommt zu Fehlern. Mehr dazu in dem Abschnitt zu typischen Problemen.

Wichtig: Wenn Sie nicht sicher sind, was Sie tun, lassen Sie die Konsole besser Fachleuten. Falsche Befehle auf dem Live-Server können Ihren Shop kurzzeitig lahmlegen. Wie Sie Ihren Shop regelmäßig sauber pflegen lassen, lesen Sie im Beitrag Shopware Wartung.

Was bedeutet Cache aufwärmen?

Nach dem Leeren ist der Cache leer. Die erste Person, die eine Seite aufruft, muss dann warten, bis sie berechnet wird. Beim Aufwärmen macht Shopware das vorab selbst. Es ruft die wichtigen Seiten auf und füllt den Cache, bevor echte Besucher:innen kommen.

Man kann es mit einem Restaurant vergleichen. Vor der Öffnung schneidet die Küche schon das Gemüse und kocht die Soßen vor. Dann geht es bei den ersten Gästen zügig.

Warum das wichtig ist:

• Die ersten Besucher:innen erleben keinen langsamen Shop.

• Die Server-Last steigt nach dem Leeren nicht plötzlich an.

• Die Suchmaschinen sehen schnelle Seiten. Das hilft der Core-Web-Vitals-Bewertung und damit dem Ranking.

Bei sehr großen Shops mit vielen Seiten kann das Aufwärmen lange dauern. Hier lohnt es sich, nur die wichtigsten Seiten aufzuwärmen, etwa Startseite, Kategorien und Bestseller. Das kann ein Entwicklungsteam einrichten.

Was sind Indizes und wann brauchen Sie sie?

Neben dem Cache gibt es in Shopware 6 noch die Indizes. Ein Index ist wie das Inhaltsverzeichnis eines Buches. Statt jede Seite durchzublättern, schaut man im Verzeichnis nach und findet sofort die richtige Stelle. Shopware nutzt Indizes, um Produkte, Kategorien, Suchergebnisse und Filter schnell zu finden.

Ein Index ist kein Cache. Er enthält berechnete Daten, die Shopware immer wieder braucht. Ändern sich die Daten, muss der Index nachgezogen werden. Meist passiert das automatisch im Hintergrund.

Wann sollten Sie Indizes neu aufbauen?

• Wenn Produkte, Preise oder Kategorien nicht richtig angezeigt werden, obwohl sie im Admin stimmen.

• Wenn die Suche alte Ergebnisse liefert.

• Wenn Filter falsche Werte zeigen.

• Nach einem großen Import von Produkten.

Der Neuaufbau kann bei großen Katalogen lange dauern und den Server belasten. Planen Sie ihn deshalb in ruhige Zeiten, zum Beispiel nachts. Wie Sie Produkte importieren, steht im Beitrag Produkte per CSV importieren. Und wie Sie die Suche verbessern, lesen Sie im Beitrag Shopware Suche optimieren.

Typische Probleme beim Leeren des Caches

Problem 1: Nach dem Leeren kommt ein Error 500. Das heißt, auf dem Server ist ein Fehler aufgetreten. Eine häufige Ursache sind falsche Dateirechte im Cache-Ordner. Wenn jemand die Befehle als falscher Benutzer ausgeführt hat, gehören die neuen Dateien dem falschen Benutzer, und der Webserver darf sie nicht lesen oder schreiben. Die Lösung: Rechte und Besitzer des Ordners für Cache und Logs korrigieren und den Cache erneut leeren. Das sollte ein Fachmann tun.

Problem 2: Der Admin lässt den Cache nicht leeren. Manchmal bricht der Vorgang ab, weil das Zeitlimit des Servers zu kurz ist oder der Shop zu groß. Dann hilft der Weg über die Konsole.

Problem 3: Änderungen sind trotzdem nicht sichtbar. Das kann an einem anderen Cache liegen:

• Browser-Cache: Laden Sie die Seite mit „Strg + Umschalt + R" oder im privaten Fenster neu.

• CDN-Cache: Wenn Sie einen Dienst wie Cloudflare nutzen, hat der einen eigenen Cache, den Sie dort leeren müssen.

• Reverse-Proxy: Setzen Sie einen Varnish oder ähnlichen Dienst ein, muss dieser ebenfalls geleert werden.

Problem 4: Theme-Änderungen erscheinen nicht. Dann wurde das Theme nicht neu gebaut. Speichern Sie die Theme-Einstellungen erneut oder führen Sie den Befehl zum Theme-Kompilieren aus.

Problem 5: Nach einem Plugin-Update sieht der Shop kaputt aus. Leeren Sie den Cache und bauen Sie das Theme neu. Hilft das nicht, prüfen Sie, ob das Plugin zu Ihrer Shopware-Version passt.

Cache im Alltag richtig nutzen

Ein guter Umgang mit dem Cache spart Ärger. Diese Regeln haben sich bewährt:

• Nur leeren, wenn nötig. Verlassen Sie sich auf Shopware, das meiste erledigt sich selbst.

• Aufwärmen gleich mit. So bleibt der Shop schnell.

• Nicht in der Hochphase. Vor einer Werbeaktion testen Sie alles früh, nicht in letzter Minute. Mehr dazu im Beitrag Black Friday in Shopware vorbereiten.

• Alle Ebenen im Blick behalten. Shopware, Browser, CDN und Proxy haben jeweils eigene Zwischenspeicher.

• Änderungen auf einer Staging-Umgebung testen. Eine Kopie des Shops hilft, Probleme vor dem Live-Gang zu erkennen.

• Nach Updates immer prüfen. Cache leeren, Theme bauen, Shop durchklicken.

Bonus: Lassen Sie den Cache nicht unnötig kurz leben. Wenn Ihr Shop Seiten sehr oft neu berechnet, liegt es manchmal an der Einstellung für die Cache-Dauer oder an Plugins, die den Cache ständig leeren. Ein Fachteam kann das prüfen und viel Geschwindigkeit gewinnen.

Bonus: Messen Sie das Ergebnis. Prüfen Sie die Ladezeit vor und nach Änderungen. Wie Sie das tun, lesen Sie im Beitrag Website-Geschwindigkeit testen.

Checkliste: Cache leeren in Shopware 6

Gehen Sie diese Liste durch:

• Ist das Leeren des Caches wirklich nötig oder liegt das Problem woanders?

• Ist gerade wenig Betrieb im Shop?

• Nutzen Sie im Admin „Caches leeren & aufwärmen"?

• Haben Sie nach einer Theme-Änderung das Theme neu gebaut?

• Haben Sie nach einem Import die Indizes neu aufgebaut?

• Haben Sie den Browser-Cache umgangen, zum Beispiel im privaten Fenster?

• Haben Sie bei CDN oder Proxy den dortigen Cache geleert?

• Läuft die Konsole unter dem richtigen Benutzer?

• Haben Sie den Shop danach durchgeklickt: Startseite, Kategorie, Produkt, Warenkorb, Checkout?

• Läuft der Shop auf Smartphone und Desktop wieder fehlerfrei?

Bonus: Dokumentieren Sie, was Sie geändert haben. Wenn mehrere Personen am Shop arbeiten, sollte jemand notieren, wann welche Änderung gemacht und welcher Cache geleert wurde. So lässt sich bei einem Fehler schnell nachvollziehen, was zuletzt passiert ist. Ein einfaches Protokoll in einem gemeinsamen Dokument reicht völlig aus und spart bei der Fehlersuche oft Stunden.

Bonus: Testen Sie als Besucher:in, nicht als Admin. Wer im Admin eingeloggt ist, sieht den Shop manchmal anders als die Kundschaft. Öffnen Sie nach jeder Änderung ein privates Fenster und klicken Sie sich ohne Login durch den Shop. Nur so sehen Sie, was Ihre Besucher:innen wirklich sehen, und erkennen sofort, ob die Änderung angekommen ist.

Wer in Shopware 6 den Cache leeren möchte, geht im Admin in die Einstellungen und wählt unter System den Bereich Caches und Indizes. Dort ist „Caches leeren und aufwärmen" meist die beste Wahl. Per Konsole geht es schneller und zuverlässiger, sollte aber von Fachleuten ausgeführt werden. Leeren Sie nur, wenn es nötig ist, nicht in der Hochphase, und denken Sie an Browser, CDN und Proxy. Bei Error 500 sind oft Dateirechte schuld. Mit diesen Regeln bleibt Ihr Shop schnell und stabil.