Nach dem Update sehen Kunden alte Styles: Cache-Busting
Kurz gesagt: Sie haben das Design Ihrer Website angepasst, doch Kunden sehen noch die alten Farben, oder die Seite wirkt halb kaputt, weil neues HTML auf altes CSS trifft. Der Browser verwendet eine zwischengespeicherte Fassung Ihrer Stylesheets und Skripte. Die saubere Lösung heißt Cache-Busting: Jede geänderte Datei bekommt einen neuen Namen, etwa style.x234dff.css, und wird mit einer langen Cache-Dauer ausgeliefert. MDN empfiehlt für solche versionierten Dateien Cache-Control: max-age=31536000, immutable. Die HTML-Seiten selbst, die auf die Dateien verweisen, werden dagegen so ausgeliefert, dass der Browser sie bei jedem Besuch prüft, etwa mit no-cache.
Woran Sie das Problem erkennen
Fehler durch veraltete Dateien im Browser-Cache sind tückisch, weil sie nur bei manchen Besuchern auftreten:
- Nach einem Update sieht die Website bei Ihnen richtig aus, eine Kundin meldet aber das alte Design.
- Ein neuer Knopf erscheint, funktioniert aber nicht, weil das zugehörige Skript noch alt ist.
- Ihre Agentur sagt „Bitte den Cache leeren“, und danach ist alles gut.
- Einzelne Seiten wirken nach dem Update verrutscht, bis man sie mehrmals neu lädt.
Besonders nach größeren Änderungen am Layout oder bei Web-Apps mit häufigen Updates fällt das auf. „Bitte Cache leeren“ ist aber keine Lösung, die man Kunden zumuten kann.
Warum der Browser alte Dateien verwendet
Damit Websites schnell laden, speichern Browser Dateien wie CSS, JavaScript, Schriften und Bilder zwischen. Wie lange, bestimmt der Header Cache-Control, den Ihr Server mitschickt. Ist dort eine lange Dauer eingetragen, fragt der Browser bis zum Ablauf gar nicht mehr nach. Ändern Sie die Datei, bleibt der Name aber gleich, nutzt der Browser weiter seine alte Kopie.
Kurze Cache-Dauern sind auch keine gute Lösung. Dann lädt oder prüft der Browser die Dateien ständig neu, und die Website wird langsamer.
Das Prinzip: neue Inhalte, neue Adresse
web.dev beschreibt den bewährten Ausweg: Versionierte Adressen machen es einfach, zwischengespeicherte Antworten ungültig zu machen. Dazu wird ein Fingerabdruck des Dateiinhalts oder eine Versionsnummer in den Dateinamen geschrieben, zum Beispiel style.x234dff.css. Ändert sich der Inhalt, ändert sich der Fingerabdruck, und damit die Adresse. Für den Browser ist es eine neue Datei, die er sofort lädt.
Laut MDN können Sie solchen versionierten Dateien eine lange max-age und immutable geben, weil sich ihr Inhalt nie ändert. Neue Inhalte bekommen eine neue Adresse, und Caches werden nicht wiederverwendet. Genau das ist mit Cache-Busting gemeint. web.dev ergänzt, dass immutable eine zusätzliche Optimierung ist, die manche Browser ignorieren. Schaden kann es nicht.
Die zwei Regeln für Ihren Server
Damit das funktioniert, brauchen Sie zwei unterschiedliche Regeln:
Versionierte Dateien mit Fingerabdruck im Namen, also CSS, JavaScript, Schriften und Bilder aus dem Build-Prozess:
Cache-Control: max-age=31536000, immutable
HTML-Seiten und andere Adressen ohne Version, die auf diese Dateien verweisen:
Cache-Control: no-cache
Laut web.dev bedeutet no-cache nicht, dass nichts gespeichert wird. Der Browser muss vor jeder Verwendung beim Server nachfragen, ob die gespeicherte Fassung noch aktuell ist. Ist sie es, antwortet der Server kurz, ohne die ganze Seite neu zu schicken. So bekommt jeder Besucher sofort das aktuelle HTML und damit die Verweise auf die neuen Dateinamen.
Fingerabdrücke automatisch erzeugen
Von Hand Dateinamen zu ändern, ist fehleranfällig. Build-Werkzeuge wie webpack können laut web.dev die Fingerabdrücke automatisch vergeben, und die Verweise im HTML werden gleich mit angepasst. Viele Frameworks und Static-Site-Generatoren machen das von Haus aus.
Bei CMS wie WordPress hängen Themes und Plugins oft eine Versionsnummer als Parameter an, etwa style.css?ver=2.4. Das funktioniert, solange die Nummer bei jeder Änderung tatsächlich steigt. Bei eigenen Anpassungen im Theme wird das gern vergessen. Prüfen Sie dann, ob Ihr Theme die Version aus dem Änderungsdatum der Datei ableiten kann, oder erhöhen Sie sie bewusst bei jedem Update.
Vorgeschaltete Caches mitdenken
Zwischen Server und Browser liegen oft weitere Caches: ein CDN, ein Seiten-Cache-Plugin oder ein Proxy beim Hoster. Auch dort gilt das Prinzip. Versionierte Dateien dürfen lange gespeichert werden, HTML-Seiten müssen nach einem Update erneuert werden. Leeren Sie nach einer Veröffentlichung gezielt den Seiten-Cache für HTML, nicht unbedingt alles. Die versionierten Dateien bleiben gültig, weil sie neue Namen tragen.
Alte Dateien nicht sofort löschen
Ein Besucher, der kurz vor dem Update eine Seite geöffnet hat, hat noch HTML mit den alten Dateinamen. Klickt er weiter, fragt sein Browser vielleicht noch eine alte Datei an. Wurde sie beim Update gelöscht, fehlen Stile oder Skripte. Behalten Sie alte Fassungen deshalb einige Tage auf dem Server, bevor Sie aufräumen.
Bilder und Dokumente ohne Build-Prozess
Nicht alle Dateien entstehen in einem Build-Prozess. Logos, Produktbilder oder PDF-Preislisten lädt Ihr Team oft direkt im CMS hoch. Ersetzen Sie eine solche Datei unter gleichem Namen, sehen Besucher womöglich lange die alte Fassung. Laden Sie aktualisierte Dateien deshalb mit neuem Namen hoch, etwa mit Datum oder Version, und passen Sie die Verweise an. Das ist auch für Ihr Team übersichtlicher, weil sich alte und neue Fassungen klar unterscheiden lassen.
So prüfen Sie Ihre Einstellungen
- Öffnen Sie die Entwicklerwerkzeuge, Netzwerk-Tab, und laden Sie eine Seite.
- Klicken Sie auf die CSS-Datei: Trägt der Name einen Fingerabdruck oder eine Version? Steht im Header eine lange max-age?
- Klicken Sie auf das HTML-Dokument: Steht dort no-cache oder eine sehr kurze Dauer?
- Ändern Sie testweise eine Farbe, veröffentlichen Sie und öffnen Sie die Seite in einem Browser, der sie vorher schon geladen hatte. Die Änderung muss ohne Cache-Leeren sichtbar sein.
Beispiel aus der Praxis
Eine Fahrradwerkstatt in Linz hat ihre Website mit neuem Buchungsknopf und überarbeitetem Farbschema aktualisiert. Stammkunden meldeten tagelang ein zerschossenes Layout. Das Stylesheet hatte einen festen Namen und eine lange Cache-Dauer, das HTML wurde ebenfalls lange zwischengespeichert. Nach der Umstellung auf Dateinamen mit Fingerabdruck, immutable für diese Dateien und no-cache für die Seiten sehen alle Besucher Änderungen sofort. Das Beispiel ist illustrativ.
Häufige Fragen
Reicht es nicht, die Cache-Dauer kurz zu halten?
Das lindert das Problem, macht die Website aber langsamer. Mit versionierten Dateinamen bekommen Sie beides: lange Speicherung und sofortige Updates.
Was bedeutet immutable?
Es teilt dem Browser mit, dass sich die Datei nie ändert und er sie während der Gültigkeit nicht erneut prüfen muss. Laut web.dev ignorieren manche Browser den Wert.
Muss ich bei jedem Update den Cache leeren lassen?
Mit Cache-Busting nicht. Nur der Seiten-Cache für HTML sollte nach einer Veröffentlichung erneuert werden.
Funktioniert eine Versionsnummer als Parameter auch?
Ja, solange sie sich bei jeder Änderung zuverlässig ändert. Ein Fingerabdruck im Dateinamen ist robuster, weil er automatisch entsteht.
Wenn Kunden nach Updates noch alte Stile sehen, richten wir Cache-Busting und Cache-Regeln gerne mit Ihnen ein: Caching prüfen lassen.