Wann Shopware den HTTP-Cache umgeht – und warum eine Änderung manchmal nicht ankommt
Der HTTP-Cache von Shopware greift nicht für jede Seite und nicht für jede Sitzung. Welche Gründe es im Kern gibt, woran Sie im Browser erkennen, welcher zutrifft, und warum Shopware 6.7 Änderungen später ausliefert als 6.6 – aus dem Quelltext von Shopware 6.6 und 6.7, abgeglichen mit 6.6.10.30 und 6.7.15.1.

„Der Shop ist langsam“ und „meine Änderung kommt nicht an“ klingen nach zwei Problemen. Hinter beidem kann derselbe Mechanismus stecken: der HTTP-Cache von Shopware. Er liefert fertige Seiten ohne erneutes Rendern aus – aber nur unter Bedingungen, die im Kern genau festgelegt sind.
Wir haben diese Bedingungen am 30.10.2026 im Quelltext von Shopware 6.6.10.6 und 6.7.2.2 nachgelesen und mit den aktuellen Versionen 6.6.10.30 und 6.7.15.1 abgeglichen. Wo sie sich unterscheiden, steht es dabei. Die Messung, was der Cache an Zeit spart, steht im Beitrag Ein Artikel im Warenkorb kostet den HTTP-Cache. Hier geht es um die Frage davor: Warum kommt eine Antwort nicht aus dem Cache?
Grund 1: Die Route ist nicht cachebar
Shopware cacht nicht jede Adresse. Eine Storefront-Route muss ausdrücklich das Attribut _httpCache tragen. In 6.7.2.2 tun das unter anderem:
| Route | Seite |
|---|---|
frontend.home.page | Startseite |
frontend.navigation.page | Kategorieseite |
frontend.detail.page | Produktdetailseite |
frontend.landing.page | Landingpage aus den Erlebniswelten |
frontend.cms.page, widgets.search.filter | nachgeladene Ausschnitte und Filter |
frontend.robots.txt, frontend.maintenance.page | robots.txt und Wartungsseite |
In 6.7.15.1 tragen alle Routen dieser Tabelle die Markierung weiterhin. Warenkorb, Kasse und Kundenkonto stehen in keiner der Versionen auf dieser Liste. In unserer Messung trugen Warenkorb, Kasse und Konto Cache-Control: no-store, private. Das ist gewollt: Diese Seiten sind für jeden Besucher anders.
Für Plugins gilt dasselbe. Eine eigene Seite eines Plugins wird nur gecacht, wenn ihr Entwickler die Route so markiert hat.
Grund 2: Die Sitzung trägt einen Cache-Zustand
Dieser Grund betrifft jede Sitzung mit Anmeldung oder Warenkorb. In der Konfiguration des Kerns steht:
shopware:
cache:
invalidation:
http_cache: ['logged-in', 'cart-filled']
Sobald ein Kunde angemeldet ist oder ein Artikel im Warenkorb liegt, setzt Shopware das Cookie sw-states mit genau diesem Wert. Beim Nachschlagen im Cache prüft der Kern, ob einer der Zustände aus dem Cookie in dieser Liste steht. Trifft das zu, gilt der Cache-Eintrag für diese Anfrage als ungültig, und Shopware rendert die Seite neu.
Die Folge in Zahlen, aus unserer Messung in einer prod-Runtime 6.7.2.2 (Kategorieseite, je fünf Abrufe): Anonyme Aufrufe aus dem Cache lagen bei rund 2 bis 5 Millisekunden, Aufrufe mit sw-states fielen in keinem Durchlauf unter 36 Millisekunden – für den Rest der Sitzung kein einziger Treffer. Details und Methode stehen in der Research zum Warenkorb-Cache.
Daneben setzt Shopware für angemeldete Kunden und gefüllte Warenkörbe ein zweites Cookie, sw-cache-hash – in 6.7.15.1 zusätzlich, wenn Währung, Lieferland, Zahlungs- oder Versandart vom Standard des Verkaufskanals abweichen. Es bildet einen Fingerabdruck aus aktiven Regeln, Währung, Steuerzustand und Anmeldestatus. Der Kern verwendet es, um für unterschiedliche Kundengruppen getrennte Cache-Einträge zu bilden.
Grund 3: Die Anfrage ist kein GET
Cache-Kopfzeilen setzt Shopware nur bei Aufrufen mit der Methode GET. In 6.6 und 6.7.2.2 gibt es eine Ausnahme für die Anmeldung, damit der neue Zustand im Cookie landet; in 6.7.15.1 ist sie entfallen. Formulare, die per POST abgeschickt werden, kommen also nie aus dem Cache. Das betrifft auch Filter, wenn ein Theme sie per POST statt per GET nachlädt.
Grund 4: Die Seite liefert 404
Seiten mit Status 404 legt Shopware nicht in den HTTP-Cache. Der Kommentar im Quelltext nennt den Grund: Es gäbe keinen Weg, den Eintrag zu entfernen, sobald die Adresse später existiert. Der Kern rendert die 404-Seite stattdessen über einen eigenen, vereinfachten Weg.
Grund 5: Der Wartungsmodus ist aktiv – für freigegebene IP-Adressen
Ist der Wartungsmodus eingeschaltet und ruft eine freigegebene IP-Adresse den Shop auf, umgeht Shopware den Cache vollständig. So sieht das Team den echten Stand, während Besucher die Wartungsseite bekommen.
Umgekehrt gilt: Für alle anderen Besucher bleibt der Cache aktiv. Das hatte in unserem Test eine sichtbare Folge. Nach sales-channel:maintenance:enable zeigte 6.6.10.6 sofort die Wartungsseite. 6.7.2.2 lieferte weiter die normale Seite aus dem Cache, auch 20 Sekunden später noch. Erst nach einem Lauf der Aufgabe shopware.invalidate_cache – oder nach cache:clear:http – kam die Weiterleitung (307) auf /maintenance, und die Wartungsseite antwortete mit 503. Die Ursache ist also die verzögerte Invalidierung aus Grund 6; das haben wir am 30.10.2026 im Produktivmodus nachgestellt und am 11.11.2026 in frischen Testinstallationen wiederholt.
Grund 6: Die Änderung ist noch nicht invalidiert
Dieser Fall ist das Gegenteil der anderen: Die Seite kommt aus dem Cache, obwohl sie es nicht mehr sollte. Wann ein Eintrag verworfen wird, regelt cache.invalidation. Hier unterscheiden sich die Versionen deutlich:
| 6.6.10.6 | 6.7.2.2 | |
|---|---|---|
| Voreinstellung | delay: 0 – sofort verwerfen | delay_enabled: true – gesammelt verwerfen |
Aufgabe shopware.invalidate_cache | läuft nur mit eingestellter Verzögerung oder Feature-Flag cache_rework | Standardintervall fünf Minuten |
In 6.7 sammelt Shopware die betroffenen Cache-Einträge also und verwirft sie im nächsten Lauf dieser geplanten Aufgabe. In 6.7.15.1 ist das unverändert voreingestellt. Eine Preisänderung kann deshalb einige Minuten lang alt angezeigt werden. Läuft der Worker für geplante Aufgaben gar nicht, bleibt der alte Stand stehen, bis jemand den Cache leert. Wie man prüft, ob die Aufgaben laufen, beschreibt der Ratgeber Warum ein Scheduled Task nicht läuft.
Was den Cache nicht umgeht
Zwei Dinge erzeugen keine eigenen Cache-Einträge, obwohl man es vermuten könnte. Erstens Kampagnenparameter: utm_source, utm_campaign, gclid, fbclid, msclkid und weitere stehen in der Liste ignored_url_parameters und werden beim Bilden des Cache-Schlüssels entfernt. Zweitens die Reihenfolge der übrigen Parameter: Der Kern sortiert sie vorher.
Eigene Parameter, etwa aus einem Newsletter-Werkzeug, sind dagegen nicht auf der Liste. Jede neue Kombination erzeugt dann einen eigenen Eintrag, und der erste Aufruf ist ungecacht.
In welcher Reihenfolge prüfen
Kurz geprüft
- Ist der HTTP-Cache überhaupt an? In der
.envsteht dafürSHOPWARE_HTTP_CACHE_ENABLED=1. - Ist die Seite eine cachebare Route? Warenkorb, Kasse und Konto sind es nie.
- Trägt die eigene Sitzung
sw-states? Dann im privaten Fenster ohne Warenkorb gegenprüfen. - Kommt die Anfrage per GET?
- Läuft die geplante Aufgabe
shopware.invalidate_cache? In 6.7 hängt die Frische der Seiten daran. - Steht ein Reverse Proxy oder CDN davor? Dann gilt dessen Konfiguration zusätzlich.
Den letzten Punkt haben wir nicht gemessen; was folgt, ist ein Hinweis, kein Befund. Shopware setzt sw-states und die Kopfzeile sw-invalidation-states auch für vorgelagerte Proxys. Ob ein Varnish oder ein CDN sie auswertet, entscheidet dessen eigene Konfiguration.
Wer hinter einem langsamen Shop einen Cache-Fehler vermutet, sollte auch die andere Möglichkeit prüfen: Sitzungen mit Warenkorb sind in der Standardeinstellung nie gecacht, und dann ist deren Renderzeit das eigentliche Thema. Daran setzt die Performance-Optimierung an. Wenn Sie die Ursache im eigenen Shop eingrenzen lassen möchten, gehört das zu unserem Shopware Support.
Shopware umgeht den HTTP-Cache absichtlich: für Kasse und Konto, für Sitzungen mit sw-states, für POST und 404. Zeigt 6.7 nach einer Änderung noch den alten Stand, ist die verzögerte Invalidierung der erste Prüfpunkt.
Häufige Fragen
- Wie sehe ich, ob meine Sitzung gecacht wird?
- In den Entwicklerwerkzeugen des Browsers unter Cookies. Steht dort sw-states mit dem Wert logged-in oder cart-filled, liefert Shopware dieser Sitzung keine Seite aus dem HTTP-Cache. Fehlt das Cookie, kann die Seite aus dem Cache kommen, sofern die Route cachebar ist.
- Kann ich den Cache für angemeldete Kunden einschalten?
- Die Liste der Zustände steht in der Konfiguration unter shopware.cache.invalidation.http_cache und ist änderbar. Wer einen Zustand entfernt, riskiert, dass Kunden personalisierte Teile einer fremden Sitzung sehen, etwa den Warenkorb-Zähler. Das ist eine Abwägung je Projekt, keine allgemeine Empfehlung.
- Warum zeigt der Shop nach einer Änderung noch den alten Stand?
- In Shopware 6.7 ist die Invalidierung standardmäßig verzögert. Die Aufgabe shopware.invalidate_cache läuft im Standard alle fünf Minuten. Läuft der Scheduled-Task-Worker nicht, bleibt der alte Stand länger stehen.
- Hilft es, einfach den ganzen Cache zu leeren?
- Kurzfristig ja, mit bin/console cache:clear:http. Danach baut sich der Cache neu auf, die ersten Aufrufe sind langsamer. Als Dauerlösung verdeckt es die eigentliche Ursache, etwa einen stehenden Worker.
- Gilt das alles auch mit Varnish oder einem CDN?
- Die Cookies und Kopfzeilen setzt Shopware auch dann. Wie ein vorgelagerter Proxy sie auswertet, hängt von dessen Konfiguration ab. Das haben wir nicht gemessen.
