Статья · 4 мин чтения · 21.10.2026
Версия файлов и кэш браузера: почему новая цена не видна
Две реальные ошибки проекта имели одну природу. Первая: цена лота обновилась в базе, но на сайте была старой. Вторая: новые кнопки фильтров не нажимались. В обоих случаях виноват кэш. Рассказываем, как мы с ним работаем.
Кэш — друг и враг
Браузеры и промежуточные серверы кэшируют статические файлы, чтобы не скачивать их повторно. Для каталога это хорошо: data.js большой. Но если файл изменился, а адрес остался прежним, браузер может показывать старую версию.
Версия по содержимому
Экспорт считает md5-хэш содержимого каталога и берёт первые 10 символов как версию. Эта версия добавляется к адресам файлов: data.js?v=…. Изменился каталог — изменилась версия — браузер загружает новый файл. Не изменился — используется кэш.
Ошибка 1: цена не обновлялась
Когда цену запускали обновлять из админки, refresh записывал новую цену в базу, но экспорт не запускался. Файлы сайта оставались старыми, версия не менялась. Решение — скрипт export_locked.sh, который админка вызывает после refresh и после запуска парсера. Он же используется в cron-цепочке.
После исправления версия каталога сменилась, и лот 39592584 показал $9 200 — в базе, в data.js, в шарде, на странице лота и на карточке.
Ключ кэша раз в минуту
Вторая часть исправления — ключ кэша для загрузки версии меняется каждую минуту. Даже если браузер закэшировал сам файл с версией, через минуту он запросит новый. В сумме новая цена появляется на сайте через 1–2 минуты после обновления.
Ошибка 2: кнопки не нажимались
Кнопки «Купить сейчас» и «Торгуется на аукционе» в коде работали, но у части посетителей не реагировали на клик. Браузер держал старую версию скриптов, где обработчика кнопок ещё не было. Вёрстка обновилась, а скрипт — нет. Решение — смена версии файлов скриптов. После этого браузеры загрузили новые скрипты.
Правило
Любое изменение статических файлов должно сопровождаться сменой версии в адресе. Для данных это делает экспорт автоматически по хэшу. Для скриптов и стилей — при выкладке.
Замок экспорта
Экспорт может быть вызван одновременно из cron, из админки и после массового сбора. Скрипт export_locked.sh берёт файловый замок: параллельные вызовы ждут друг друга до 30 минут, а не пишут одновременно. Файлы сайта создаются с правами 644.
Как проверить, что исправление сработало
Мы проверили исправление по цепочке: значение в базе, значение в data.js, значение в шарде страницы лота, сама страница лота и карточка в каталоге. Во всех пяти местах лот 39592584 показывал $9 200. Хэш версии каталога сменился с a60eb20de3 на 7c44cc5c90 — это подтверждает, что браузеры получат новый файл.
Такая проверка «по всей цепочке» полезна для любых данных, которые проходят через несколько слоёв: ошибка может прятаться в любом из них.
Почему не отключить кэш совсем
Без кэша каждый посетитель на каждом заходе скачивал бы весь каталог заново. Это медленно для посетителей и тяжело для хостинга. Версионирование даёт лучшее из двух миров: файл кэшируется надолго, пока не изменился, и мгновенно обновляется, когда изменился.
Вопросы и ответы
Что делать, если у посетителя старая версия? Обычно достаточно подождать минуту и обновить страницу: ключ версии сменится.
Нужно ли менять версию стилей вручную? При выкладке изменений — да. Данные каталога версионируются автоматически.
Коротко
Версия файлов по md5 содержимого, ключ версии меняется раз в минуту, экспорт под замком после каждого обновления из админки. Новая цена — на сайте через 1–2 минуты.
Итог
Версия по содержимому и короткий ключ кэша дают баланс: быстро для посетителя и актуально для данных. Посмотреть актуальные цены можно в демо-каталоге, схему экспорта — на странице парсера.
Что почитать дальше
Эта статья — часть цикла о парсере аукционных лотов JetAero. Все цифры в ней взяты из кода и баз проекта на 21 октября 2026 года и меняются с каждым прогоном. Архитектуру системы целиком, таблицу площадок и список функций смотрите на странице «Парсер аукционных лотов», а результат работы — в демо-каталоге jetaero.pro/auctions, где лоты можно отфильтровать по площадке, году, цене, пробегу и статусу торгов. Мы сознательно не приводим в статьях выдуманных цифр, отзывов и историй клиентов: если какого-то значения нет в данных проекта, мы так и пишем. Цены и ставки в примерах — реальные значения из баз на дату публикации, а расчёт под ключ в каталоге — ориентир, а не оферта. Если вам нужна похожая система для своих площадок, начните со знакомства с демо-каталогом, а затем напишите нам — обсудим, какие источники и данные нужны именно вам.
- Курсы НБРБ: автоматическая загрузка для пересчёта цен
- Цены в долларах по курсу НБРБ: оригинал и эквивалент
- Расчёт под ключ до Минска: из чего он складывается
