Все статьи

После обновления видна старая версия сайта: как разобраться с кэшем

Материал обновлён 21 октября 2026 года.

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

Разделите страницу и её ресурсы

В учебном примере страница заказа загружает HTML, файл оформления и скрипт формы. Они могут обновляться в разное время. Запишите, какой именно элемент выглядит устаревшим, где это происходит и когда замечена проблема. Сохраните снимок экрана и название браузера. Такая запись позволит повторить проверку после исправления.

Затем откройте сетевые инструменты разработчика. Сопоставьте адреса и содержимое HTML, CSS и JavaScript с выпущенной версией. Если новая разметка загружает старый скрипт, причина отличается от случая, когда сам документ пришёл из прежней копии. У приложения также может быть собственный механизм хранения ресурсов, который нужно учитывать отдельно.

Найдите слой, вернувший сохранённый ответ

Руководство MDN по HTTP-кэшированию различает частный кэш пользователя и общие кэши, обслуживающие несколько клиентов. На практике в цепочке сайта могут участвовать браузер, CDN и серверный слой. Для диагностики выясните, кто отвечает за каждый из них и где посмотреть настройки либо результаты обработки конкретного запроса.

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

Прочитайте правила ответа

В документации MDN объясняются Cache-Control, срок свежести и повторная проверка сохранённого ответа. Похожее написание директив не означает одинакового поведения.

Две директивы Cache-Control
ДирективаЧто означает
no-cacheДопускает хранение ответа с необходимостью проверки перед повторным использованием
no-storeЗапрещает хранение ответа

Выбор настройки должен учитывать назначение ответа и последствия его хранения.

Для разработчика полезна небольшая таблица: тип ресурса, текущий заголовок, ожидаемое поведение и способ проверки. Отдельно рассмотрите публичное оформление, HTML-страницу и ответы с данными пользователя. Применимость общего кэша к персональным данным нужно оценивать специально. Правило для фотографии каталога нельзя автоматически переносить на содержимое личного кабинета.

Проверяйте также валидаторы, например ETag, и условные запросы. Они позволяют сопоставлять сохранённую версию с актуальной. В журнале диагностики отметьте статус ответа и полученные заголовки. Само наличие ответа 304 описывает результат проверки версии; оно требует чтения вместе с остальной цепочкой загрузки.

Спланируйте следующий выпуск

Для изменяемых CSS и JavaScript можно использовать имена, связанные с содержимым или версией сборки. Тогда новый документ ссылается на новые ресурсы. Это рекомендация по организации выпуска, которую нужно согласовать с хостингом и сборкой. Старые файлы полезно сохранять доступными на период, когда их ещё могут запрашивать открытые страницы.

Завершите выпуск обычным пользовательским маршрутом:

  1. Откройте страницу после обновления и проверьте согласованную версию ресурсов.
  2. Заполните форму и проверьте предусмотренный результат.
  3. Повторите путь при ранее открытой вкладке и после нового открытия.
  4. Зафиксируйте, какой слой очищается при выпуске, кто отвечает за действие и по каким признакам подтверждается новая версия.

Сохранённые условия пригодятся при следующем обращении о старой версии страницы.

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

Настройку обновления ресурсов и диагностику старых версий сайта можно обсудить с Семёном Дулесовым.

Какой элемент вашего сайта чаще всего остаётся старым после выпуска изменений?