Das hier ist das Entwickler-Pendant zu Warum dein Magento-2-Shop trotz Varnish und Redis langsam wirkt. Den schickst du dem Händler. Dieser Artikel ist für dich.
Wenn du schon mehr als eine Handvoll Magento-2-Shops auditiert hast, kennst du das Bild: Varnish läuft, Redis läuft, die Hardware ist in Ordnung, und die Hit-Rate liegt trotzdem weit unter dem, was sie sein sollte. Die Maschine langweilt sich, PHP macht die ganze Arbeit. Bei den Shops, auf die dieses Muster im letzten Jahr zutraf, war es fast immer dieselbe kurze Liste von Ursachen. Hier ist, wie du sie findest, in der Reihenfolge, die deine Zeit am ehesten wert ist.
TL;DR
Hit-Raten unter 30 Prozent auf einem Magento-2-Shop haben so gut wie immer eine dieser Ursachen, meistens sogar mehrere gleichzeitig:
-
Set-Cookie: PHPSESSID=...auf Antworten, die eigentlich als Gast-Traffic cachebar sein sollten. -
PHP sendet
Cache-Control: no-storeoderno-cache, weil eine Erweiterung$response->setNoCacheHeaders()aufgerufen oder ungefragt eine Session gestartet hat. - Die als FPC-Tag-Store konfigurierte Redis-Datenbank hat 0 Keys, dadurch scheitern tag-basierte Purges still, und Varnish kann getaggte Objekte nie sauber ablegen.
-
X-Magento-Varyfragmentiert den Cache pro Gerät, pro Währung, pro Store View, meistens ohne dass das irgendwer so gewollt hat. -
VCL, die Layered-Nav-Parameter nicht normalisiert und Marketing-Parameter nicht strippt (
gclid,utm_*,fbclid,srsltid), sodass jeder Ad-Klick ein kalter MISS ist. -
Ein, zwei Marketplace-Erweiterungen, die
setPublicCookie()aufrufen oder bei jedem Request aus einem Block, Observer oder Layout-XML-Include eine Session starten.
Fixt man das Cookie und den No-Store-Header, erholt sich die Hit-Rate meistens schon an einem Nachmittag deutlich. Der Rest der Liste ist das, was dich auf 90 Prozent und mehr bringt.
Die tatsächliche Hit-Rate messen
Bevor du irgendwas anfasst: Baseline nehmen. Ohne Zahl hast du keinen Bug, sondern ein Bauchgefühl.
Der kürzeste Weg ist varnishstat:
1varnishstat -1 | grep -E 'cache_hit|cache_miss'
Gesunde Ausgabe auf einem normalen Storefront: cache_hit liegt eine Größenordnung über cache_miss. Wenn cache_miss in derselben Größenordnung liegt wie cache_hit oder sogar darüber, bist du genau in dem Terrain, um das es hier geht. Notier dir die exakten Werte, du brauchst später einen Vorher-Nachher-Vergleich.
Für einen Live-Blick liefert varnishstat -1 einen Snapshot, varnishstat ohne Flags öffnet die interaktive TUI. Im MAIN-Abschnitt findest du cache_hit, cache_miss, cache_hitpass und cache_hitmiss. Ein hoher cache_hitpass-Wert bedeutet, dass Requests auf ein hit-for-pass-Objekt treffen, meistens ein Symptom des Cookie-/No-Store-Problems weiter unten und kein eigenständiger Bug.
Wenn du Granularität pro URL brauchst, sample eine Minute lang varnishlog:
1varnishlog -g request -q 'ReqMethod eq "GET"' -i ReqURL,RespHeader:X-Magento-Cache-Debug,VCL_call
Gesund: Die meisten GETs auf Kategorie- und Produkt-URLs loggen VCL_call HIT. Wenn du auf einer nackten /herrenschuhe-URL ohne Cookies MISS und X-Magento-Cache-Debug: MISS siehst, hast du ein Cachebarkeitsproblem, kein Traffic-Problem.
Der übliche Verdächtige: Set-Cookie auf jeder Antwort
Das ist der Killer. Varnish kommt mit VCL, die jede Antwort mit Set-Cookie als nicht cachebar behandelt, und Magentos Standard-VCL hält an diesem Verhalten für alles außerhalb der eigenen Allow-List fest. Ein einziger unbedachter setPublicCookie()-Aufruf in einem Block, der auf jeder Seite rendert, und schon läuft dein ganzer Storefront nur noch als Pass-Through-Traffic.
Schau dir die Antwort an. Das ist der nützlichste einzelne Befehl in diesem ganzen Artikel:
1curl -sI https://storefront.example.com/ | grep -iE 'cache-control|set-cookie|x-magento-vary|x-cache|age'
Gesunde Ausgabe auf einer Gast-Startseite:
1Cache-Control: max-age=86400, public, s-maxage=864002X-Magento-Vary: ... # Hash vorhanden, das ist okay3Age: 43 # Varnish liefert ein gecachtes Objekt aus
Kaputte Ausgabe, das wirst du wahrscheinlich als Erstes sehen:
1Cache-Control: no-store, no-cache, must-revalidate, max-age=02Set-Cookie: PHPSESSID=abc123...; path=/
Wenn Set-Cookie: PHPSESSID bei einer Anfrage auftaucht, bei der eigentlich gar keine Session hätte starten sollen, hat irgendetwas in der Request-Kette genau das getan. PHPs session_start() ist eifrig: Alles, was $_SESSION liest, Magento\Framework\Session\SessionManager::start() aufruft oder eine Klasse nutzt, die das transitiv tut, feuert das Cookie. Varnish verweigert danach das Caching.
Um die Quelle schnell zu finden, grepp app/code nach den üblichen Verdächtigen:
1grep -rn --include='*.php' -E 'setPublicCookie|->start\(\)|SessionManager|CustomerSession|CheckoutSession' app/code/ | grep -v Test
Gesund: Treffer nur in Checkout-, Customer- und Wishlist-Modulen. Alles, was in einem Block, Observer, Layout-Processor oder generischen Helper auf Katalogseiten rendert, ist verdächtig. Session-Starts fanden sich in unseren Audits schon in Header-Blocks, in Promo-Bannern, in GeoIP-Helpern und einmal sogar in einem „Währungserkenner", der mit Sessions eigentlich gar nichts zu tun haben sollte.
session_start. Magentos Session-Manager wrappt das. Such nach SessionManager, CustomerSession, CheckoutSession, ->start( und setPublicCookie. Letzteres ist heimtückisch: setPublicCookie() startet selbst keine Session, aber verbreitete Marketplace-Cookie-Consent-Erweiterungen fahren bei jedem Aufruf eine DB-Query, dazu gleich mehr.
Der zweite Verdächtige: Cache-Control: no-store aus PHP
Manchmal ist das Cookie gar nicht das Problem. Stattdessen sagt die Antwort selbst Varnish, sie nicht zu cachen, und zwar über PHP. Das passiert, wenn eine Erweiterung Cache-Control: no-store oder no-cache direkt in die Response-Header schreibt, meistens in einem beforeDispatch-Plugin oder einem dispatch-Observer.
Magentos \Magento\PageCache\Model\Config::isEnabled() und das PageCacheHeader-Plugin sollen eigentlich max-age und public setzen. Läuft danach noch etwas, das das überschreibt, hast du verloren. $response->setNoCacheHeaders() ist der übliche Täter.
Prüf deine gemergte Plugin-/Observer-Konfiguration:
1bin/magento dev:di:info 'Magento\Framework\App\Response\Http' 2>&1 | head -50
Du suchst nach Plugins in der Magento\Framework\App\Response\Http-Pipeline, die dort eigentlich nichts verloren haben. Ein Plugin aus einem Nicht-Core-Modul mit Around auf sendHeaders oder sendResponse ist ein Warnsignal. Lies es. Wenn es konditional Cache-Control: no-store setzt, abhängig von einem Cookie, das bei jedem Request existiert, hast du deine Regression gefunden.
Ein minimales, korrektes Plugin sieht so aus:
1final class PreserveCacheHeaders2{3 public function beforeSendResponse(\Magento\Framework\App\Response\Http $subject): void4 {5 // fasst auf cachebaren Routen die Cache-Header nicht an6 }7}
Ein kaputtes sieht aus wie ein unkonditional aufgerufenes $subject->setHeader('Cache-Control', 'no-store', true). Diese eine Zeile drückt deine Hit-Rate auf jeder Route, die sie berührt, auf Null.
FPC-Redis-Store leer? Dein tag-basiertes Purging ist kaputt
Magento speichert die Full-Page-Cache-Tags in einer eigenen Redis-Datenbank. Welche Datenbanknummer das genau ist, hängt vollständig davon ab, wie der Shop in app/etc/env.php konfiguriert wurde, es gibt keine Vorgabe, dass es ein bestimmter Index sein muss. Finde erst raus, was tatsächlich konfiguriert ist, bevor du Redis abfragst:
1grep -A 10 'page_cache' app/etc/env.php
Such nach dem database-Wert unter backend_options im page_cache-Frontend-Eintrag. Das ist der DB-Index, den du abfragen willst.
1redis-cli -n <deine_page_cache_db> dbsize
Gesund: irgendwo zwischen ein paar tausend und mehreren hunderttausend Keys auf einem aktiven Shop. Null ist es nicht.
Wenn die FPC-Datenbank (integer) 0 zurückgibt, geh die übliche Checkliste durch:
-
app/etc/env.phphatcache->frontend->page_cache, das auf eine Redis-Instanz zeigt (nicht aufdefault, nicht fehlend), mit explizit gesetztemdatabase-Key. -
CM_Cache_Backend_Redisist als Backend-Klasse konfiguriert, und der Datenbank-Index inenv.phpstimmt mit dem überein, was du abfragst. -
bin/magento cache:enable full_pagemeldet den Cache als aktiviert. -
Varnishs
vcl_backend_responsein deiner VCL entfernt nicht versehentlich denX-Magento-Tags-Header aus der Backend-Antwort (alte Custom-VCLs machen das manchmal „der Sauberkeit wegen" und zerschießen damit Tag-Purges).
Warum das wichtig ist: Ohne befüllten FPC-Tag-Store funktioniert tag-basierte Invalidierung schlicht nicht. bin/magento cache:flush trifft den Default-Cache, Varnishs PURGE-Request geht raus, aber der Tag-Store, mit dem das koordiniert sein soll, ist leer. Varnish scheint zwar zu cachen, aber Objekte laufen nur über TTL ab, nicht über Content-Änderungen. Auf einem statischen Katalog sieht die Hit-Rate dann okay aus und bricht am Tag nach einem Bulk-Produktimport ein, weil jede Produktseite missed und Varnish den ganzen Cache kalt neu befüllen muss.
X-Magento-Vary: wenn Desktop und Mobile deinen Cache fragmentieren
X-Magento-Vary ist der Weg, mit dem Magento Varnish mitteilt: „Diese Antwort ist spezifisch für diese Kundengruppe, diese Währung, diesen Store View." Der Hash deckt die im DI-Container registrierten HTTP-Context-Variablen ab, standardmäßig Login-Status, Kundengruppe, Währung und Store. Erweiterungen können weitere hinzufügen. Varnish speichert pro eindeutigem Vary-Hash ein gecachtes Objekt. Zu viele unterschiedliche Hashes, und du cachst faktisch pro Besucher, was gleichbedeutend mit gar nicht cachen ist.
Prüf, worauf du tatsächlich fragmentierst:
1for i in 1 2 3 4; do curl -sI -A "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15" \2 https://storefront.example.com/ | grep -i x-magento-vary; done
Gesund: viermal derselbe Hash. Der Vary-Hash bleibt innerhalb einer Geräteklasse stabil und kippt nicht bei jedem Request.
Die übliche Pathologie: Desktop und Mobile erzeugen unterschiedliche Vary-Hashes für dieselbe logische Seite und verdoppeln damit deinen Arbeitsbestand. Fährst du bewusst getrennte Desktop-/Mobile-Themes über Magentos Design-Config, ist das Absicht, und die Hit-Rate-Obergrenze halbiert sich effektiv. Tust du das nicht und siehst trotzdem zwei Hashes pro URL, kippt irgendetwas in design/*/view.xml oder in einem Theme-Plugin den Hash unnötig auf Basis des User-Agents.
Ein billiger Sanity-Check: Desktop-TTFB gegen Mobile-TTFB auf derselben URL, vom selben Standort aus, samplen. Ist Desktop auf cachebaren Kategorieseiten mehr als doppelt so langsam wie Mobile, misst du wahrscheinlich auf Desktop und hittest auf Mobile (oder umgekehrt), weil der Cache entlang einer Geräte-Achse fragmentiert ist, die so gar nicht geplant war.
VCL-Hygiene: Layered-Nav-Parameter und Marketing-Parameter
Deine VCL entscheidet in vcl_recv, was letztlich im Cache-Key landet. Dabei zählen zwei Stellschrauben.
Layered-Navigation-Parameter. Eine URL wie /herrenschuhe?brand=nike&price=50-100&p=2 sollte cachebar sein. Jeder Magento-Shop hat das Problem irgendwann. Normalisiert deine VCL den Query-String nicht (alphabetisch sortieren, kleinschreiben, Nulls entfernen), sind ?brand=nike&price=50-100 und ?price=50-100&brand=nike zwei verschiedene Cache-Einträge. Multipliziert über alle Filterkombinationen, und du landest wieder beim kalten Cache.
Der Standard-Fix ist ein std.querysort()-Aufruf plus eine konservative Whitelist an Filter-Parametern in vcl_recv. Magentos Referenz-VCL in vendor/magento/module-page-cache/etc/varnish6.vcl enthält std.querysort(req.url) bereits. Fehlt das in deiner VCL, ergänz es.
Marketing-Parameter. gclid, fbclid, utm_source, utm_medium, utm_campaign, srsltid, _gl, epik, mc_cid, mc_eid sind für die Seite selbst semantisch irrelevant. Das ist Attribution, die Ad-Plattformen dranhängen. Nimmst du sie in den Cache-Key auf, ist jeder Ad-Klick ein kalter MISS. Strip sie vor dem Hashing:
1sub vcl_recv {2 # Marketing-Parameter vor querysort entfernen3 set req.url = regsuball(req.url, "(\?|&)(gclid|fbclid|utm_[^=]+|srsltid|_gl|epik|mc_cid|mc_eid)=[^&]*", "");4 set req.url = regsub(req.url, "\?&", "?");5 set req.url = regsub(req.url, "\?$", "");6 set req.url = std.querysort(req.url);7}
Gesund danach: Die TTFB von Google-Ads-Traffic ist vergleichbar mit organischem Traffic. Kaputt davor: Google-Ads-Traffic kann auf exakt derselben URL 2- bis 3-mal langsamer sein als organischer, weil jeder gclid-Wert einen neuen Cache-Eintrag erzeugt.
X-Magento-Vary, private_content_version, form_key, mage-cache-sessid, section_data_ids) und liefert dann gelegentlich gecachte Seiten an eingeloggte Kunden aus. Hat dein CDN eine cache_everything-Regel auf HTML-Pfaden, deaktivier sie.
Modulmuster, die wir immer wieder sehen
Dieselbe Handvoll Marketplace-Module taucht in diesen Audits immer wieder auf. Drei Muster sind es wert, benannt zu werden.
Plumrocket CookieConsent: eine DB-Query pro setPublicCookie(). Das Modul fährt bei jedem gesetzten Public Cookie eine Datenbankabfrage, und es setzt mehrere pro Seite. Auf einem kalten Seitenaufruf siehst du dadurch allein vier bis zehn zusätzliche Queries. Über die Query-Kosten hinaus landet jeder setPublicCookie()-Aufruf in Response-Headern, über die Varnish dann entscheiden muss. Der Fix ist entweder, das Modul zu entfernen, oder den Cookie-Config-Lookup für die Dauer des Requests statisch im Speicher zu cachen.
Bss_PromotionBar: Session-Start bei jedem Request. Der Observer, der die Kundengruppen-ID für den Promo-Balken holt, greift auf die Customer-Session zu, was session_start() auslöst und damit Set-Cookie: PHPSESSID auf Antworten, die eigentlich als Gast cachebar sein sollten. Ein Cache-Layer um den Gruppen-ID-Lookup hilft bei der DB-Last, aber solange der Observer die Session anfasst, cacht Varnish die Antwort trotzdem nicht. Der einzig echte Fix ist, den Lookup auf eine zustandslose Quelle umzuschreiben, etwa ein Cookie, das eine kleine Edge-Side-Logik setzt, oder einen Client-seitigen AJAX-Personalisierungsaufruf, nachdem das cachebare HTML schon geladen ist.
Bss_FacebookPixel: das richtige Muster. Erwähnenswert, weil es der positive Fall ist. Die Session-Storage-Klasse des Moduls lässt sich als In-Memory-DTO umschreiben, gescoped auf den Request, ganz ohne Aufrufe in Magentos Session-Manager. Keine Session-Contention, kein Set-Cookie, und der Pixel feuert trotzdem. Wenn du ein Magento-Modul schreibst, das für Gäste „session-scoped" Daten braucht, ist das das Muster: request-scoped DTO statt Session.
Amasty_Geoip und Plumrocket_GeoIPLookup. GeoIP-Module neigen stark dazu, schwere Datenbanken zu laden oder bei jedem Request eine Session zu starten, nur um das Land zu bestimmen. Auf einem Varnish-gefronteten Shop ist jede Per-Request-GeoIP-Logik mit Caching schlicht unvereinbar. Verschieb den Lookup entweder auf einen Edge-Worker und gib das Ergebnis als Header weiter, auf den Varnish varyen kann, oder erledige es client-seitig, nachdem die cachebare Hülle geladen ist.
MSP_NoSpam und ältere Mageworx-Module. Historisch gab es hier zu weit gefasste Session-Starts bei jedem Controller-Dispatch. Die meisten sind mittlerweile zugunsten zustandsloser Ansätze deprecated. Läuft bei dir noch ein alter Build, der solche Module mitschleppt, ist Entfernen meistens die richtige Entscheidung.
Generelle Regel: Jedes Modul, das cachebares HTML personalisieren will, macht etwas falsch. Personalisierung gehört in den private_content_version/section_data_ids-AJAX-Layer, nicht in die initiale HTML-Antwort.
Weiterführende Artikel
-
Redis Session Locking in Magento 2: wann
disable_locking=1deinen Checkout rettet. Varnish und Redis Session Locking potenzieren sich auf demselben langsamen Seitenpfad; stimmt deine Hit-Rate und der Shop fühlt sich bei eingeloggten Interaktionen trotzdem langsam an, ist der Lock der nächste Punkt auf deiner Liste. - Observer-Rekursion in Magento 2: die versteckten Kosten von sales_order_save_after. Ist die Danke-Seite nach dem Checkout die langsame Seite, ist der Cache unschuldig, meistens steckt eine Observer-Kaskade dahinter.
- Die N+1-Falle auf Magento-2-Produktseiten: getUsedProducts und Freunde. Die andere Hälfte von „PDP fühlt sich langsam an". Cache-Misses erklären eine langsame Anfrage, N+1 erklärt, warum jede Anfrage langsam ist, sobald sie PHP erreicht.
Die 8-Punkte-Checkliste für Magento-Varnish-Audits
-
Hit-Rate als Baseline nehmen
Führ varnishstat -1 | grep -E 'cache_hit|cache_miss' aus und notier das Verhältnis. Unter 30 % ist kaputt. Unter 80 % ist es wert, nachzuschauen. Nach jedem Fix erneut laufen lassen, um die Bewegung zu bestätigen.
-
Response-Header auf einer Gast-Seite prüfen
curl -sI auf Startseite und eine Kategorie. Cache-Control sollte max-age=N, public sein. Kein Set-Cookie auf Gast-Antworten. X-Magento-Vary vorhanden, Age steigt bei wiederholten Requests.
-
Nach ungewollten Session-Starts greppen
grep -rn --include='*.php' -E 'setPublicCookie|->start\(\)|SessionManager|CustomerSession|CheckoutSession' app/code/. Jeder Treffer außerhalb von Checkout-, Customer- oder Wishlist-Code ist verdächtig. Lesen, prüfen, ob die Session dort wirklich nötig ist.
-
FPC-Redis-Datenbank auf Befüllung prüfen
grep -A10 'page_cache' app/etc/env.php, um den konfigurierten Datenbank-Index zu finden, dann redis-cli -n <diese_db> dbsize. Null bedeutet: FPC-Tag-Storage ist kaputt, tag-basierte Purges scheitern still, und der Cache altert nur über TTL. Erst env.php fixen, dann bin/magento cache:flush und erneut prüfen.
-
Response-Header-Pipeline auditieren
bin/magento dev:di:info 'Magento\Framework\App\Response\Http'. Jedes Nicht-Core-Plugin auf sendHeaders oder sendResponse ist Kandidat dafür, Cache-Control zu überschreiben. Jedes einzeln lesen und bestätigen, dass kein no-store erzwungen wird.
-
X-Magento-Vary-Stabilität bestätigen
Dieselbe URL viermal mit demselben UA und denselben Cookies abrufen. Der Vary-Hash muss übereinstimmen. Driftet er, varyt irgendetwas den Hash auf Request-scoped State, der da nicht reingehört.
-
Query-Strings in der VCL normalisieren
std.querysort() muss in vcl_recv stehen. gclid, fbclid, utm_*, srsltid, _gl, epik, mc_cid, mc_eid vor dem querysort entfernen. Die Layered-Nav-Parameter auf eine Whitelist setzen, die du wirklich separat cachen willst.
-
Bekannt problematische Erweiterungen identifizieren
Plumrocket CookieConsent (DB-Query pro Cookie), Bss_PromotionBar (Session-Start im Observer), GeoIP-Module (Per-Request-DB-Lookups). Prüfen, ob sie aktiv sind. Falls ja: entfernen, zustandslos umschreiben, oder die Hit-Rate-Kosten bewusst einkalkulieren.
Bei 25 % festgefahren und die Ideen gehen aus?
Wir führen fokussierte Magento-2-Performance-Audits durch. Du bekommst die varnishstat-Zahlen, die genaue Erweiterung, die deine Hit-Rate killt, einen VCL-Diff und eine priorisierte Fix-Liste. Keine 80-seitige PDF. Zwei bis drei Tage, direkt am Code.