ВебЛикбез3 мин чтения

Почему браузер показывает старую версию сайта

Разбираем Cache-Control, ETag, ответы 304 и обновление статических CSS и JavaScript.

Кеш — это не ошибка браузера

Браузеры и промежуточные кеши могут сохранять ответы, чтобы следующие загрузки были быстрее и экономнее. Пока сохранённый ресурс считается свежим, браузер вправе использовать его, не отправляя новый запрос. Поэтому обновление файла на сервере не всегда означает немедленное обновление страницы у каждого посетителя.

Причину обычно можно найти в заголовках HTTP — через вкладку Network в DevTools либо командой curl -I.

Свежесть и повторная проверка

Cache-Control: max-age=3600 позволяет считать ответ свежим до одного часа. no-cache не запрещает хранение: он требует проверить актуальность перед повторным использованием. no-store указывает кешам не сохранять ответ.

Для проверки браузер может передать If-None-Match со значением ранее полученного ETag. Если содержимое не изменилось, сервер может ответить 304 Not Modified без повторной передачи файла.

Версионирование CSS и JavaScript

Надёжный подход — менять URL при изменении CSS или JS. Особенно удобны имена с хешем содержимого, например main.a43f2.css. Такие ресурсы можно долго кешировать, а обновлённый HTML будет указывать на новые имена файлов.

Для небольшого сайта иногда достаточно параметра версии: /assets/styles.css?v=3. Это создаёт новый URL, хотя конкретное поведение всё равно зависит от настроек кеширования.

Если HTML обновился, а CSS сохранился в длительном кеше под прежним URL, посетитель может увидеть новую разметку со старыми стилями.

Обновление без промежуточных состояний

При замене набора файлов можно сначала загрузить их во временный каталог, а после завершения переключить символическую ссылку или указатель на новую версию. Тогда посетитель не получит HTML, который ссылается на ещё не загруженные ресурсы.

Модуль file_server Caddy читает статические файлы непосредственно с диска: после изменения HTML перезапуск Caddy не требуется. Но фактическое появление новой версии у посетителя по-прежнему зависит от кеширования.

← Все статьи
ИЗБРАННЫЕ МАТЕРИАЛЫ

Читать дальше

Все статьи