Материал блога
В Shop-Script показывается старое фото товара: как проверить оригинал, миниатюры и кеш

Менеджер заменил фотографию товара, в административной части виден новый файл, но покупатель по-прежнему видит старую картинку. Иногда проблема проявляется только в каталоге, на мобильном устройстве или у одного варианта товара. Не стоит сразу удалять все изображения и очищать весь кеш магазина: нужно определить, какой файл фактически отдаёт сайт и где именно возникло расхождение.
Этот порядок подходит для Shop-Script с обычной темой и для магазинов, где изображения изменяют плагины, импорт или CDN. Названия настроек зависят от версии и конфигурации: проверяйте фактические URL и ответы сервера, а не предполагаемое поведение.
Зафиксируйте симптом и выберите контрольные страницы
Сохраните URL товара, ID товара, артикул конкретного SKU, адрес изображения, время замены и два скриншота: как фото выглядит в редакторе и как — на публичной странице. Отдельно проверьте карточку товара, плитку категории, результаты поиска, блок рекомендаций и мобильную витрину.
Если новая фотография появляется в карточке, но не появляется в категории, вероятная зона проверки — размер миниатюры, кеш страницы или отдельный шаблон списка. Если на всех страницах старое фото, начните с данных самого товара и источника загрузки. Для магазина с несколькими витринами дополнительно укажите домен и тему оформления каждой витрины.
Проверьте исходное изображение и порядок фотографий
Откройте товар в редакторе и убедитесь, что новая фотография действительно сохранена в нужном товаре и установлена основной, если требуется именно основное изображение. Проверьте, не прикреплён ли новый файл к другому товару или варианту. При массовом импорте сверяйте стабильный идентификатор записи, а не одно название.
Для разработчика доступен официальный метод shop.product.images.getList, который возвращает список изображений товара, их ID, размеры, порядок и ссылки на эскизы. В shop.product.images.getInfo можно запросить информацию об одном изображении и его миниатюре заданного размера. Это диагностические средства при наличии разрешённого API-доступа, а не требование использовать API для каждой проверки.
Важно различать замену файла с сохранением прежней записи и удаление старой фотографии с добавлением новой: при разных реализациях импорта и плагинов идентификаторы и ссылки могут вести себя по-разному. Не удаляйте историю фотографий на рабочем сайте до резервного копирования.
Разделите оригинал, эскиз и изображение в шаблоне
На странице магазина через инструменты разработчика найдите фактический адрес изображения, которое показывает браузер. У элемента могут быть src, srcset и несколько размеров для адаптивной загрузки; браузер выбирает не обязательно тот URL, который виден первым в HTML. Сравните фактически загруженный файл с изображением в административной части.
Shop-Script использует эскизы изображений разных размеров. Официальная документация описывает хук image_generate_thumb, который срабатывает перед генерацией эскиза и позволяет плагинам влиять на процесс. Поэтому правильный оригинал и неправильный эскиз — отдельный сценарий неисправности.
Проверьте конкретный размер, который требует шаблон, и существует ли файл по его адресу. Если небольшая картинка верна, а крупная — старая, сравните их URL, дату изменения и ответ сервера. Не подменяйте диагноз массовой регенерацией всех файлов.
Сверьте HTTP-ответ, кеш браузера и CDN
Запросите проблемный URL изображения напрямую и запишите код ответа, Content-Type, размер файла и заголовки кеширования. Ответ 404 означает иную проблему, чем корректный 200 с устаревшим содержимым. Если используется CDN или прокси-кеш, определите, какой узел возвращает старую версию: исходный сервер, CDN или браузер.
Откройте страницу в приватном окне и сравните результат на другом устройстве. Это полезный тест, но сам по себе не доказывает причину: приватный режим тоже получает файлы из общего CDN. При необходимости используйте запрос с отключённым кешированием в инструментах разработчика и сопоставьте содержимое полученных файлов.
Если версия в хранилище уже обновлена, а CDN ещё отдаёт старый объект, очистите конкретный URL или примените согласованный механизм изменения версии адреса. Массовая очистка всех кешей может увеличить нагрузку и временно ухудшить доступность витрины.
Проверьте тему оформления и изображения вариантов
Шаблон списка товаров, карточка и мобильные блоки могут запрашивать разные размеры изображения. Сверьте настройки изображения в теме, а затем код вывода в изменённых шаблонах. Важно проверить не только HTML, но и JavaScript, который меняет фотографию при выборе SKU.
Для товаров с несколькими вариантами выберите каждый проблемный артикул и проверьте соответствие изображения. Если одна и та же фотография автоматически показывается при переключении варианта, уточните источник привязки в настройках товара и в коде темы. Не предполагайте, что общая галерея и изображения SKU устроены одинаково во всех установленных версиях.
Когда проблема связана с нестандартным шаблоном, может потребоваться доработка Shop-Script и темы с тестированием всех размеров и вариантов, а не только заменой одного URL.
Исключите повторную загрузку старого фото интеграцией
В магазинах с автоматическим обновлением каталога старая фотография может возвращаться после очередного обмена. Проверьте журнал импорта и расписание интеграции: не обновляет ли внешний источник изображения после ручного редактирования. Для диагностики полезно зафиксировать время замены фото и время последнего обмена.
Если внешняя система отвечает за фотографии, договоритесь о правиле владения данными: какие изображения можно менять вручную и какие должны обновляться автоматически. Не выключайте всю интеграцию ради проверки одной карточки; сначала протестируйте на ограниченном наборе товаров или в тестовом окружении.
Проверьте плагины обработки изображений
Плагины сжатия, изменения формата, водяных знаков, импорта и генерации миниатюр могут изменять итоговый файл или его адрес. Сопоставьте список активных расширений с датой появления ошибки и последними обновлениями. При наличии тестовой копии поочерёдно воспроизводите процесс с контролируемой конфигурацией.
Не отключайте обработчики изображений на рабочей витрине без плана отката: изменение формата или адресов файлов может затронуть тысячи карточек. Зафиксируйте исходные настройки, подготовьте резервную копию и оцените, какие старые эскизы потребуется пересоздать после исправления.
Вносите исправления по масштабу проблемы
Если неверно выбрана основная фотография, исправьте порядок только у нужного товара. Если проблема в одном размере эскиза, сначала восстановите этот размер для тестовой карточки. Если ошибка в теме, исправьте шаблон и проверьте srcset на разных ширинах экрана. Если виноват CDN, обновите конкретные кешированные объекты.
Регенерация миниатюр всего каталога может занять значительное время и место на диске. Перед такой операцией уточните фактический объём файлов, возможности хостинга и необходимость её выполнения. Для планового сопровождения ошибок изображений и обновлений полезна техническая поддержка интернет-магазина.
Сверьте результат на карточке, в каталоге и поиске
После исправления проверьте исходный URL и размеры миниатюр, отображение товара в категории и поиске, переключение вариантов, мобильный экран и обновление без авторизации. Сравните несколько товаров: изменённый, соседний и тот, который был загружен до обновления темы. Убедитесь, что нет битых изображений, неожиданной обрезки и повторного появления старой фотографии после следующего импорта.
Если фото участвует в товарных фидах или внешних интеграциях, проверьте передаваемые ссылки отдельно: они могут обновляться по другому расписанию. Смежные примеры изменений магазина собраны в портфолио доработок Quadro Design, однако конкретная диагностика зависит от конфигурации проекта.
Вывод: при старой фотографии в Shop-Script нужно последовательно сравнить запись товара, оригинал, требуемую миниатюру, URL из шаблона и ответ кеширующих слоёв. Сначала локализуйте место расхождения, затем исправьте один проверяемый случай и только после этого распространяйте решение на каталог.