Cache-Fehler in WooCommerce und wie man sie verhindert

Ursachen für Cache-Fehler bei Warenkorb, Sitzung und Kassenseite in WooCommerce; richtige Ausnahmen für Seitencache, Cloudflare und Redis sowie Testmethode.
Technische Zusammenfassung
Technologie
WooCommerce, Seitencache, Cloudflare, Redis
Thema
Cache-Probleme im E-Commerce
Niveau
Mittel
In diesem Beitrag5 Abschnitte

Ein Kunde legt ein Produkt in den Warenkorb, die Seite lädt neu, und der Warenkorb ist leer. Oder schlimmer: Auf der Kassenseite stehen Name und Adresse eines anderen Kunden. In WooCommerce lassen sich fast alle diese Symptome auf eine einzige Grundursache zurückführen: Eine personenspezifische Seite wird in einer der Cache-Ebenen wie eine öffentliche Seite gespeichert. Dieser Leitfaden beschreibt die Cache-Fehler, die wir in der Praxis am häufigsten sehen, ihre Ursachen und die richtige Konfiguration auf Ebene von Seitencache, Cloudflare und Redis.

Warum passiert das so oft?

Ein Shop hat gleichzeitig zwei Arten von Seiten: Seiten, die für alle gleich aussehen (Startseite, Kategorie, Produkt), und personenspezifische Seiten (Warenkorb, Kasse, Mein Konto). Cache-Ebenen – pluginbasierter Seitencache, Server-Cache (nginx FastCGI cache, Varnish, LiteSpeed) und CDN – kennen diese Unterscheidung nicht von selbst. Sie müssen über URL- und Cookie-Regeln lernen, welche Anfrage personenspezifisch ist. Ist auch nur eine Ebene falsch konfiguriert, tritt der Fehler auf.

WooCommerce sendet auf Warenkorb-, Kassen- und Mein-Konto-Seiten selbst Header, die das Cachen verhindern, und definiert die Konstante DONOTCACHEPAGE. Die meisten Cache-Plugins halten sich daran. Das Problem beginnt meist auf einer höheren Ebene: eine CDN-Regel, die Origin-Header ignoriert, eine nginx-Konfiguration, die Cookies nicht berücksichtigt, oder ein Reverse Proxy nach dem Prinzip „alles cachen“. Das Plugin mag richtig arbeiten. Die Ebene davor überschreibt es.

Der zweite häufige Grund: Die Ebenen werden ohne Wissen voneinander eingerichtet. Sind Plugin-Cache, Server-Cache und Cloudflare APO gleichzeitig aktiv, weiß niemand, woher welche Antwort kommt; die Bereinigung (Purge) erfolgt nur in einer, die anderen beiden liefern weiter alte Inhalte. Das Erste, was wir in der Praxis tun, ist, jede Ebene, die die Anfrage durchläuft, und ihre Regel zu Papier zu bringen.

Häufige Fehler und ihre Ursachen

Symptom Mögliche Ursache Lösung
Warenkorb oder Name eines anderen Nutzers sichtbar Anfragen mit Sitzung wurden im CDN oder auf dem Server gecacht Anfragen mit WooCommerce- und Sitzungscookies auf allen Ebenen umgehen
Alter Preis/Versand auf der Kassenseite Kassenseite im Cache /warenkorb, /kasse, /mein-konto und deren Endpunkte ausnehmen
„In den Warenkorb“ funktioniert nicht, Warenkorbzähler aktualisiert sich nicht Seite mit Nonce lange im Cache; AJAX-/Fragments-Anfrage gecacht Cache-Dauer an die Nonce-Lebensdauer anpassen, wc-ajax-Anfragen umgehen
Nicht vorrätiges Produkt erscheint als „auf Lager“ Bei Bestandsänderung wird die Produktseite nicht bereinigt Bei Bestands-/Preisaktualisierung die betroffenen URLs bereinigen
Falscher Bestellstatus nach Rückkehr von der Zahlung Callback-Adresse des Zahlungsanbieters im Cache oder von der WAF blockiert Callback-Endpunkte von Cache- und WAF-Regeln ausnehmen

Die erste Zeile der Tabelle ist die gefährlichste, weil sie kein Performance-Problem, sondern ein Datenleck ist. Trägt eine gecachte Antwort auch einen Set-Cookie-Header, wird das Sitzungscookie eines Besuchers an nachfolgende Besucher verteilt, und alle landen im selben Warenkorb. Sehen Sie dieses Symptom, schalten Sie zuerst den Seitencache komplett ab und finden dann die Ursache, indem Sie die Ebenen einzeln wieder aktivieren. Zuerst die Blutung stoppen.

Eine weitere übersehene Quelle sind Shops mit mehreren Sprachen und Währungen. Werden Sprache oder Währung per Cookie gewählt und berücksichtigt der Cache dieses Cookie nicht im Schlüssel, kann ein Besucher, der die türkische Seite öffnet, die englische Seite oder statt TL Preise in Euro erhalten. Dasselbe zeigt sich bei der standortbasierten Steuerberechnung von WooCommerce; für dieses Szenario gibt es in den WooCommerce-Einstellungen die Option „Geolocate (with page caching support)“, die der URL einen Standortparameter hinzufügt und so den Cache-Schlüssel trennt.

Richtige Konfiguration: Ebene für Ebene

Seitencache (Plugin oder Server)

  • Warenkorb-, Kassen- und Mein-Konto-Seiten ausgenommen (mit ihren Entsprechungen in Ihrer Sprach- und Permalink-Struktur).
  • Ist eines der Cookies woocommerce_items_in_cart, woocommerce_cart_hash, wp_woocommerce_session_* oder wordpress_logged_in_* vorhanden, wird der Cache umgangen.
  • Anfragen mit ?add-to-cart= und wc-ajax werden nicht gecacht.
  • Die Cache-Dauer wird kürzer als die Lebensdauer der WordPress-Nonce (standardmäßig 12–24 Stunden) gehalten oder der Cache regelmäßig erneuert.

Nutzen Sie statt eines Plugins nginx FastCGI cache, müssen Sie diese Regeln selbst schreiben: Aus Anfrage-URI und Cookies wird eine Variable $skip_cache erzeugt, dann werden mit den Zeilen fastcgi_cache_bypass $skip_cache; und fastcgi_no_cache $skip_cache; sowohl Lesen als auch Schreiben verhindert. Der häufigste Fehler in der Praxis ist, nur die Bypass-Zeile zu schreiben. Dann liest der angemeldete Nutzer nicht aus dem Cache, schreibt seine Antwort aber hinein; der nächste anonyme Besucher sieht die Seite dieser Person. Beide Zeilen sind nötig.

Auch Mini-Warenkorb-Komponenten aus Seitenbearbeitern (Elementor, Block-Theme) erfordern Aufmerksamkeit. Bettet die Komponente den Warenkorbzähler in das HTML der Seite ein, trägt die gecachte Seite den alten Wert. Der Warenkorbzähler muss über eine eigene dynamische Anfrage kommen (Fragments oder blockbasierter Mini-Warenkorb).

Cloudflare

  • Wird HTML-Cache genutzt (Cache Rules / APO), wird für WooCommerce- und Sitzungscookies eine Bypass-Bedingung definiert.
  • Callback-Adressen von Zahlungsanbietern und REST-API-Endpunkte werden vom Cache und von aggressiven WAF-Regeln ausgenommen.
  • Die Regel „Cache Everything“ wird nicht bedingungslos angewendet.

Beim Cachen von HTML per Cache Rules die Edge-TTL so einzustellen, dass die Cache-Control-Header des Origins ignoriert werden, bedeutet, auch das „nicht cachen“-Signal von WooCommerce wegzuwerfen. Wird diese Einstellung gewählt, müssen Cookie- und Pfadausnahmen ausdrücklich in der Regel definiert sein. Auch die Regelreihenfolge zählt; wird die Bypass-Regel nach einer weit gefassten Cache-Regel ausgewertet, liefert sie nicht das erwartete Ergebnis.

Die Server-zu-Server-Benachrichtigungen (Webhook/Callback) eines Zahlungsanbieters sind keine Browser. Stoppen Bot Fight Mode, JavaScript-Challenge oder länderbasierte Sperren diese Anfragen, wird die Zahlung zwar eingezogen, die Bestellung bleibt aber „ausstehend“. Nehmen Sie den Callback-Pfad in den WAF-Regeln aus und beschränken Sie ihn, falls der Zahlungsanbieter in seiner Dokumentation eine IP-Liste veröffentlicht, auf diese.

Objektcache (Redis)

Redis beschleunigt Seiten, die nicht im Seitencache landen können, und ist sicher nutzbar; Sitzungsdaten werden über den eigenen Mechanismus von WooCommerce verwaltet. Speicherlimit und Verdrängungsrichtlinie müssen eingestellt werden. Zur allgemeinen Funktionsweise der Ebenen siehe den Leitfaden zu Cloudflare, WP Rocket und Redis.

In der Praxis wird maxmemory passend zum Serverspeicher begrenzt und als Verdrängungsrichtlinie z. B. allkeys-lru gewählt; ohne Limit wächst Redis und verknappt den Speicher von PHP-FPM und MariaDB. Teilen sich mehrere Websites dieselbe Redis-Instanz, muss jede ein eigenes Präfix oder eine eigene Datenbanknummer nutzen. Sonst leert die Bereinigung einer Website auch die andere, schlimmer noch: Schlüssel kollidieren.

Testszenario

Verlassen Sie sich bei Tests nicht auf den Browser, sondern auf die Antwortheader. Mit curl -sI https://domain/produkt/beispiel/ werden cf-cache-status, x-cache oder der Header Ihrer Cache-Ebene gelesen; wird dieselbe Anfrage mit -H "Cookie: woocommerce_items_in_cart=1" wiederholt, muss die Antwort am Cache vorbei kommen. Liefert auch die zweite Anfrage HIT, funktioniert die Cookie-Ausnahme nicht.

  1. Öffnen Sie im privaten Fenster eine Produktseite; der Cache-Header sollte HIT zeigen.
  2. Legen Sie ein Produkt in den Warenkorb; prüfen Sie, dass sich der Zähler aktualisiert und folgende Seiten am Cache vorbei (BYPASS/MISS) kommen.
  3. Öffnen Sie dieselbe Seite in einem anderen Browser; prüfen Sie, dass der Warenkorb des ersten Nutzers nicht sichtbar ist.
  4. Prüfen Sie, dass Gutschein- und Versandänderungen auf der Kassenseite sofort wirken.
  5. Führen Sie eine Testzahlung durch; prüfen Sie, dass Bestellstatus und E-Mails korrekt sind.
  6. Ändern Sie im Admin-Bereich den Bestand; prüfen Sie, dass sich die Produktseite aktualisiert.

Diese Tests sollten nach jeder Änderung an Plugins oder Cache-Einstellungen wiederholt werden. Außerdem verringert die Kompatibilität mit HPOS (High-Performance Order Storage) für Bestelltabellen die Datenbanklast in großen Shops.

Lassen Sie den Test nicht bis kurz vor die Kampagne liegen. Ein Cache-Fehler unter hohem Traffic bedeutet Verlust von Umsatz und Kundendaten; müssen Sie zum Rückgängigmachen den Cache abschalten, steht der Server gleichzeitig unter Last. Testen Sie Änderungen in einer Testumgebung mit denselben Cache-Ebenen wie die Produktion.

Häufig gestellte Fragen

Warum zeigt der Warenkorbzähler einen falschen Wert?

Kommt die Seite aus dem Cache, kann der Warenkorbzähler den Wert zum Zeitpunkt des Cachens zeigen. Warenkorbfragmente (Fragments) oder der blockbasierte Mini-Warenkorb müssen dynamisch geladen und diese Anfragen nicht gecacht werden.

Können Produktseiten gecacht werden?

Ja; für anonyme Besucher lassen sich Produkt- und Kategorieseiten cachen. Ändern sich Bestand und Preis, muss die betreffende Seite bereinigt werden; gibt es personenspezifische Preise (B2B), muss der Cache für angemeldete Nutzer umgangen werden.

Beschleunigt Redis WooCommerce?

Ja; besonders auf Seiten, die nicht im Seitencache landen können, wie Warenkorb, Kasse, Mein Konto und Admin-Bereich, senkt es die Datenbanklast. Die langsame Abfrage selbst behebt es aber nicht.

Um Cache- und Performancekonfiguration Ihres Shops gemeinsam aufzubauen, siehe unsere Leistungen WooCommerce-E-Commerce und Cache- und CDN-Optimierung für WordPress.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge