Если после переноса пропали картинки, возьмите один конкретный элемент 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 изображения, ожидаемый относительный путь, контрольная сумма оригинала и нужные варианты размеров. Сравните его с новым хранилищем. Если отсутствуют только производные, сначала проверьте генератор на нескольких исходниках. Не запускайте массовую пересборку, пока не определены прежние размеры, правила кадрирования и формат: новые миниатюры могут визуально отличаться.
- Выбрать карточку с JPEG-оригиналом и несколькими вариантами.
- Проверить прямой URL оригинала.
- Проверить каждый адрес из srcset.
- Сравнить настройки базового media URL с данными шаблона.
- Восстановить один отсутствующий вариант и повторить браузерный тест.
Относительный путь в базе и абсолютный адрес в HTML решают разные задачи. Если домен изменился, исправьте источник формирования URL, когда данные действительно относительные. Если в базе хранятся абсолютные ссылки, подготовьте ограниченную выборку и карту преобразования. Не делайте глобальную замену строки в сериализованных данных без инструмента, понимающего их формат.
Восстановление подтверждает выбор браузера
После правки проверьте узкое и широкое окно: браузер может выбирать разные файлы из одного srcset. Снимите сохранённые проблемные адреса повторно и сравните статусы. При использовании CDN не очищайте весь кеш наугад; сначала подтвердите доступность объекта на origin и затем обновите конкретные связанные адреса по правилам провайдера.
Откат должен возвращать прежнюю настройку путей или прежние значения ограниченной выборки. Файлы с нового сервера не удаляют, пока карта соответствий не проверена. Для помощи достаточно одного HTML-элемента, currentSrc, заголовков ответа и обезличенного пути в хранилище. Эта цепочка показывает точку разрыва без передачи всей базы и доступа к прежнему серверу.