Der Inhalt wurde aktualisiert, der Besucher sieht aber noch die alte Seite; oder umgekehrt: Es gibt ein CDN, aber jede Anfrage geht zum Ursprungsserver. Die Wurzel beider Beschwerden liegt meist an derselben Stelle: dem Header Cache-Control. Bis eine Antwort den Besucher erreicht, durchläuft sie Browser-Cache, CDN und gegebenenfalls einen Reverse Proxy; wie lange jede Ebene speichert und wann sie neu validiert, entscheidet dieser Header. Dieser Leitfaden erklärt die Semantik des HTTP-Cachings auf Basis von RFC 9111 und schlägt werkzeugunabhängige Header-Sets für statische Assets, HTML und Seiten mit Sitzung vor.
HTTP-Cache-Ebenen
RFC 9111 unterscheidet zwei Arten von Caches. Ein privater (private) Cache gehört einem einzelnen Nutzer; der Browser-Cache ist das typische Beispiel. Ein gemeinsamer (shared) Cache beliefert mehrere Nutzer; CDN und Reverse Proxy gehören dazu. Die praktische Konsequenz ist klar: Nutzerspezifische Inhalte (Kontoseite, Warenkorb) dürfen im Browser gespeichert werden, im gemeinsamen Cache aber nie. Wird diese Linie überschritten, geht die Seite eines Nutzers an einen anderen.
Die Lebensdauer einer Antwort im Cache wird über zwei Begriffe gesteuert:
- Frische (Freshness): Die Zeit, in der die Antwort ohne Rückfrage beim Ursprungsserver genutzt werden darf. Festgelegt mit
max-ageoders-maxage. Wie lange eine aus dem Cache gelieferte Antwort bereits gespeichert ist, zeigt der HeaderAge. - Validierung (Validation): Nach Ablauf der Frische fragt der Cache den Ursprungsserver: „Ist das noch gültig?“ Der Server vergleicht mit
ETagoderLast-Modified; hat sich der Inhalt nicht geändert, liefert er304 Not Modifiedohne Body.
Tabelle der Cache-Control-Direktiven
Häufig genutzte Antwortdirektiven und ihre Bedeutung stehen unten. stale-while-revalidate und stale-if-error sind in RFC 5861, immutable in RFC 8246 definiert; die übrigen in RFC 9111.
| Direktive | Bedeutung | Achtung |
|---|---|---|
max-age=N |
Gilt N Sekunden lang als frisch | Gilt für alle Caches |
s-maxage=N |
Frische nur für gemeinsame Caches | Überschreibt max-age im CDN |
no-cache |
Speicherbar, muss bei jeder Nutzung validiert werden | Bedeutet nicht „kein Caching“ |
no-store |
Wird in keinem Cache gespeichert | Für sensible Daten; beeinträchtigt die Performance der Zurück-Taste |
private |
Nur der Browser darf speichern | Personenspezifische Inhalte |
public |
Auch gemeinsame Caches dürfen speichern | Erlaubt Speichern selbst bei authentifizierten Antworten |
must-revalidate |
Darf nach Veralten nicht ohne Validierung ausgeliefert werden | Ist der Ursprung nicht erreichbar, wird ein Fehler geliefert |
stale-while-revalidate=N |
Veraltete Antwort wird N Sekunden ausgeliefert, während im Hintergrund erneuert wird | Unterstützung variiert je nach Browser und CDN |
immutable |
Inhalt ändert sich während der Frischedauer nicht | Nur bei versionierten Dateinamen |
Der Header Expires ist ein alter Mechanismus und wird ignoriert, wenn max-age vorhanden ist. Pragma: no-cache existiert nur für HTTP/1.0-Kompatibilität; in moderner Konfiguration ist er unnötig. Manche CDNs unterstützen den in RFC 9213 definierten Header CDN-Cache-Control; er steuert nur das CDN-Verhalten, ohne den an den Browser gesendeten Cache-Control-Wert zu berühren. Das in der Praxis am häufigsten verwechselte Paar ist no-cache und no-store. Das eine sagt „validieren“, das andere „(nicht) speichern“.
Langfristiger Cache für statische Assets
Aus Sicht der Webperformance ist bei CSS-, JavaScript-, Schrift- und Bilddateien diese Strategie am effizientesten: Ändert sich der Inhalt, ändert sich die URL, und die Datei bleibt sehr lange im Cache. Das nennt man „Fingerprinting“ oder Cache Busting: An den Dateinamen wird ein Inhalts-Hash angehängt wie app.3f9a1c.css, oder ein Versionsparameter wie style.css?ver=2.4.0 genutzt. Ändert sich die URL, ändert sich auch der Cache-Schlüssel, und der Nutzer erhält die neue Datei.
Cache-Control: public, max-age=31536000, immutable
In Nginx wird dieser Header nach Dateiendung so gesetzt:
location ~* \.(?:css|js|woff2|avif|webp|jpg|jpeg|png|svg)$ {
add_header Cache-Control "public, max-age=31536000, immutable" always;
access_log off;
try_files $uri =404;
}
In Apache, wenn mod_headers aktiv ist:
<FilesMatch "\.(css|js|woff2|avif|webp|jpe?g|png|svg)$">
Header set Cache-Control "public, max-age=31536000, immutable"
</FilesMatch>
Diese Regel hat eine Voraussetzung: Die URL jeder Datei, die nach Dateiendung langfristig gecacht wird, muss sich ändern, wenn sich ihr Inhalt ändert. In WordPress werden Theme- und Plugin-Dateien über den Parameter ?ver= versioniert; Plugins, die ein Bild in der Mediathek unter demselben Namen ersetzen, oder manuell ohne Versionsparameter hochgeladene Dateien brechen diese Annahme jedoch. Ergebnis: ein Jahr lang das alte Logo. In Nginx können verschachtelte location-Blöcke und die Vererbungsregeln von add_header zu unerwarteten Ergebnissen führen; ein einziges add_header im untergeordneten Block hebt alle add_header-Zeilen im übergeordneten Block auf. Verifizieren Sie die Konfiguration nach jeder Änderung per Header-Prüfung; zur Header-Verwaltung auf Reverse-Proxy-Ebene siehe den Leitfaden zum Nginx-Reverse-Proxy.
Strategie für HTML und dynamische Inhalte
Da sich die URL von HTML nicht ändert, darf kein langer Browser-Cache vergeben werden; sonst erreicht eine Inhaltsaktualisierung den Nutzer tagelang nicht. Der ausgewogene Ansatz ist, im Browser jedes Mal zu validieren und im CDN eine kurze Frischedauer zu definieren:
# Oeffentliches HTML fuer nicht angemeldete Besucher
Cache-Control: public, max-age=0, s-maxage=600, stale-while-revalidate=60
# Personenspezifische Seiten (Konto, Warenkorb, Kasse)
Cache-Control: private, no-cache
# Antworten mit sensiblen Daten
Cache-Control: no-store
In der ersten Zeile validiert der Browser die Seite bei jedem Besuch; das CDN liefert sie dagegen 10 Minuten lang ohne Ursprungsanfrage aus und gibt Anfragen in den 60 Sekunden nach Ablauf die veraltete Kopie, während es im Hintergrund erneuert. Um bei Veröffentlichungen nicht 10 Minuten zu warten, binden Sie das Purge (Bereinigen) der betroffenen URLs in den Veröffentlichungsablauf ein: aktualisierter Beitrag, Startseite, Kategoriearchiv und gegebenenfalls Sitemap. Manche CDNs bieten tagbasierte Bereinigung; diese Funktion hängt von Plan und Anbieter ab. Ohne Purge ist eine kürzere TTL keine Lösung. Sie senkt nur die Trefferquote.
Weiterleitungen werden oft übersehen. 301-Antworten können auch ohne expliziten Cache-Header standardmäßig gecacht werden, und Browser können sie lange speichern. Eine falsche 301 auf dem Server zu korrigieren, korrigiert nicht die Browser, die sie bereits erhalten haben. Nutzen Sie bei Umzügen oder Umstrukturierungen für Weiterleitungen, deren Dauerhaftigkeit nicht feststeht, zunächst 302 oder vergeben Sie ein explizites max-age.
Vary, Cookies und Cache-Lecks
Der Header Vary teilt dem Cache mit, nach welchen Request-Headern er für dieselbe URL getrennte Kopien halten muss. Vary: Accept-Encoding ist der Standard, um komprimierte und unkomprimierte Kopien zu trennen. Vary: User-Agent oder Vary: Cookie machen dagegen fast jede Anfrage einzigartig und lassen die Trefferquote im gemeinsamen Cache einbrechen. Auch die Vary-Unterstützung der CDNs ist begrenzt; die meisten verarbeiten nur bestimmte Werte.
Das eigentliche Risiko ist, dass eine personenspezifische Antwort in den gemeinsamen Cache geschrieben und anderen Nutzern ausgeliefert wird. Dieses „Cache-Leck“ ist kein Performanceproblem, sondern ein Datenleck. Typische Ursachen:
publicoders-maxageim HTML, das an einen angemeldeten Nutzer geht.- Die CDN-Regel ignoriert das Cookie und speichert die Antwort, obwohl sie
Set-Cookieenthält. - Unvollständig aufgeführte Sitzungscookies in der Regel zum Umgehen des Caches. Typische Beispiele sind für WordPress Cookies mit den Präfixen
wordpress_logged_in_,wp-postpass_undcomment_author_, für WooCommerce Cookies mit den Präfixenwoocommerce_items_in_cartundwp_woocommerce_session_. - Personalisierte Teile (Warenkorbzähler, Benutzername) werden im Frontend serverseitig ins HTML geschrieben.
Die dauerhafte Lösung für den letzten Punkt ist, personenbezogene Teile vom HTML zu trennen und über eine eigene, nicht gecachte Anfrage zu füllen. Für typische Szenarien auf E-Commerce-Websites siehe den Leitfaden zu Cache-Fehlern in WooCommerce, für das Zusammenspiel von Seitencache, CDN und Objektcache den Leitfaden zu Cloudflare, WP Rocket und Redis.
Header verifizieren und Fehler beheben
Verifizieren Sie die Cache-Konfiguration in der Webinfrastruktur von Unternehmen nicht im Browser, sondern auf der Kommandozeile. Der Browser kann wegen seines eigenen Caches und seiner Erweiterungen irreführende Ergebnisse liefern. Da manche Server auf HEAD andere Header liefern als auf GET, ist eine GET-Anfrage mit verworfenem Body verlässlicher:
# Antwortheader anzeigen, Body verwerfen
curl -s -o /dev/null -D - https://www.beispiel.de/
# Wie ein Browser anfragen, der Kompression akzeptiert
curl -s -o /dev/null -D - -H 'Accept-Encoding: br, gzip' https://www.beispiel.de/assets/app.css
# Bedingte Validierung: mit dem ETag der vorherigen Antwort wird 304 erwartet
curl -s -o /dev/null -D - -H 'If-None-Match: "5f2a-63b1c9e0"' https://www.beispiel.de/
# Anfrage mit Sitzungscookie: darf nicht aus dem Cache kommen
curl -s -o /dev/null -D - -H 'Cookie: wordpress_logged_in_test=1' https://www.beispiel.de/
Zu prüfende Header in der Ausgabe und ihre Deutung:
| Angabe | Was sie zeigt |
|---|---|
Cache-Control |
Vom Ursprung oder CDN angewandte Richtlinie |
Age |
Wie viele Sekunden die Antwort bereits im gemeinsamen Cache liegt |
ETag / Last-Modified |
Ist eine Validierung möglich? |
Vary |
In den Cache-Schlüssel einfließende Request-Header |
| Anbieterspezifischer Status-Header | Trefferstatus; z. B. bei Cloudflare cf-cache-status (HIT, MISS, EXPIRED, BYPASS, DYNAMIC) |
Die Prüfreihenfolge ist einfach. Senden Sie dieselbe Anfrage zweimal hintereinander: Zeigt die zweite Antwort keinen Treffer und steigt Age nicht, speichert das CDN die Antwort nicht; prüfen Sie zuerst den vom Ursprungsserver gesendeten Header, dann die CDN-Regel. Wiederholen Sie dieselbe Anfrage danach mit Sitzungscookie. Zeigt die Anfrage mit Sitzungscookie einen Treffer, besteht ein ernstes Risiko eines Cache-Lecks. Beheben Sie das zuerst.
Um Seitencache, CDN-Regeln und Header-Richtlinien auf WordPress-Websites von Unternehmen gemeinsam zu entwerfen, siehe unsere Leistung Cache- und CDN-Optimierung für WordPress. Die normative Definition aller Direktiven steht in RFC 9111.
Häufig gestellte Fragen
Bedeutet no-cache, dass nicht gecacht wird?
Nein. no-cache besagt, dass die Antwort gecacht werden darf, vor jeder Verwendung aber beim Ursprungsserver validiert werden muss. Die Validierung erfolgt mit ETag oder Last-Modified; hat sich der Inhalt nicht geändert, liefert der Server eine 304-Antwort ohne Body. Soll die Antwort in keinem Cache gespeichert werden, verwenden Sie no-store.
Was passiert, wenn kein Cache-Control-Header gesendet wird?
Laut RFC 9111 können Caches bei fehlender expliziter Frische-Angabe für bestimmte Statuscodes eine heuristische Frische berechnen; gibt es einen Last-Modified-Header, wird eine Dauer nach dem Alter der Datei bestimmt. Dieselbe Datei wird also in verschiedenen Browsern und CDNs unvorhersehbar lange gespeichert. Definieren Sie für jeden Antworttyp einen expliziten Cache-Control-Wert; nur so verschwindet die Unklarheit.
Wozu dient die Direktive immutable?
immutable gibt an, dass sich die Antwort während ihrer Frischedauer nicht ändert. Unterstützende Browser senden für diese Ressourcen selbst beim Neuladen der Seite keine bedingte Validierungsanfrage. Nutzen Sie es nur bei Assets mit Version oder Hash im Dateinamen; bei einer Datei, deren Inhalt sich unter derselben URL ändert, sehen Nutzer weiter die alte Version.
Ist es sicher, HTML im CDN zu cachen?
Für Seiten, die nicht angemeldeten Besuchern denselben Inhalt zeigen, ist es sicher, und bei Cache-Treffern verbessert sich die TTFB meist deutlich. Die Bedingungen: Anfragen mit Sitzungs-, Warenkorb- und Personalisierungscookies müssen den Cache umgehen, Antworten mit Set-Cookie dürfen nicht in den gemeinsamen Cache geschrieben werden, und bei Inhaltsänderungen müssen die betroffenen URLs bereinigt werden.