Если после переноса пропали картинки, возьмите один конкретный элемент img и найдите адрес, который браузер действительно запрашивает. Сопоставьте currentSrc, ответ в Network и путь к файлу на новом сервере. Не меняйте сразу все URL в базе: проблема может находиться в одной настройке document root или в отсутствующих миниатюрах.

Сохраните резервную копию данных и список проблемных адресов до исправления. Разберите отдельно оригинал, миниатюру и CDN-адрес. Наличие original.jpg в uploads не доказывает, что перенесён файл original-600.webp, который выбрал srcset. Начальный тест должен показать, какие именно объекты отсутствуют.

Ответ сервера определяет следующий шаг

ОтветПроверка
404совпадают ли URL, document root и путь файла
403права чтения и правила доступа конкретного пути
200 с text/htmlне вернул ли роутер страницу вместо изображения
200 с изображениемдекодирование и способ показа
Перенаправление на прежний доменисточник абсолютного адреса и правила redirect

HTTP 404 означает, что ресурс по запросу не найден, но сам по себе не сообщает, потерян ли файл навсегда. Ответ 200 тоже не подтверждает изображение: приложение может вернуть HTML-заглушку. Сравните Content-Type и содержимое через безопасный просмотрщик. Не открывайте произвольный загруженный файл как исполняемый код ради диагностики.

Имя из URL должно совпасть с именем в хранилище

# Условный Linux-путь; команды только читают сведения
stat -- /srv/example/public/uploads/catalog/Product-A.jpg
namei -l -- /srv/example/public/uploads/catalog/Product-A.jpg
# В браузере отдельно сравните точный URL и регистр Product-A.jpg

Замените условный путь на проверенный путь нового сайта. stat показывает объект, а namei помогает увидеть компоненты пути и их права. Не выдавайте рекурсивно полные права всей папке, если ошибка относится к одному уровню. Проверьте, какой пользователь обслуживает файлы и какую часть дерева он должен читать.

На системах с чувствительными к регистру именами Product-A.jpg и product-a.jpg могут быть разными путями. Перед массовым переименованием найдите возможные конфликты: два разных файла способны отличаться только регистром. Автоматическое приведение всех имён к нижнему регистру без карты соответствий может уничтожить связь с данными каталога.

Оригиналы и производные сверяют раздельно

Составьте manifest: ID изображения, ожидаемый относительный путь, контрольная сумма оригинала и нужные варианты размеров. Сравните его с новым хранилищем. Если отсутствуют только производные, сначала проверьте генератор на нескольких исходниках. Не запускайте массовую пересборку, пока не определены прежние размеры, правила кадрирования и формат: новые миниатюры могут визуально отличаться.

  1. Выбрать карточку с JPEG-оригиналом и несколькими вариантами.
  2. Проверить прямой URL оригинала.
  3. Проверить каждый адрес из srcset.
  4. Сравнить настройки базового media URL с данными шаблона.
  5. Восстановить один отсутствующий вариант и повторить браузерный тест.

Относительный путь в базе и абсолютный адрес в HTML решают разные задачи. Если домен изменился, исправьте источник формирования URL, когда данные действительно относительные. Если в базе хранятся абсолютные ссылки, подготовьте ограниченную выборку и карту преобразования. Не делайте глобальную замену строки в сериализованных данных без инструмента, понимающего их формат.

Восстановление подтверждает выбор браузера

После правки проверьте узкое и широкое окно: браузер может выбирать разные файлы из одного srcset. Снимите сохранённые проблемные адреса повторно и сравните статусы. При использовании CDN не очищайте весь кеш наугад; сначала подтвердите доступность объекта на origin и затем обновите конкретные связанные адреса по правилам провайдера.

Откат должен возвращать прежнюю настройку путей или прежние значения ограниченной выборки. Файлы с нового сервера не удаляют, пока карта соответствий не проверена. Для помощи достаточно одного HTML-элемента, currentSrc, заголовков ответа и обезличенного пути в хранилище. Эта цепочка показывает точку разрыва без передачи всей базы и доступа к прежнему серверу.

Проверенные источники