AIfra / Практика

Сайт опубликовался, а картинка пропала: как найти причину

Успешная загрузка не гарантирует, что все ссылки внутри HTML верны. Разбираем отсутствие файла, регистр имени и адреса из локального редактора.

Начните с адреса картинки

Если заголовки видны, а изображение не появилось, сначала посмотрите src, а не пересоздавайте всё превью. Часто HTML уже опубликован правильно, но нужного файла нет в загруженной папке или его имя отличается.

В нашем примере HTML содержит missing.png, а архив только index.html. Публикация проходит, потому что HTML допустим. При отдельном запросе картинки обработчик возвращает 404. Сервис не скачивает недостающий ресурс за автора.

<!-- Этот путь требует файла рядом с index.html -->
<img src="missing.png" alt="Демонстрация">

Наблюдение в тесте: missing.png → HTTP 404

Проверьте три вещи в готовой папке

Первое: файл действительно находится в dist, а не только в исходном src. Второе: имя в HTML совпадает с именем на диске, включая регистр. Третье: относительный путь рассчитан от того документа, который открыт сейчас.

Адрес localhost, путь с буквой диска или временный URL из редактора не следует отправлять клиенту. Попросите агента показать список ресурсов итоговой сборки и сопоставить его с href и src. Для Vite или React проверяйте результат локальной сборки, а не исходный компонент.

Положите картинки и шрифты в папку сайта

Текущая защита превью запрещает загружать изображения и шрифты с внешних сайтов. Это правило действует даже тогда, когда сторонний адрес доступен в вашей сети. Положите нужные ресурсы в готовую папку и исправьте пути, если правообладатель разрешает их распространять.

После загрузки проверьте всю страницу: успешный ответ HTML ещё не означает, что каждый локальный ресурс найден. Для показа в РФ без VPN откройте итоговую ссылку из нужной сети. Не снимайте ограничения безопасности ради декоративной картинки.

После исправления обновите ту же публикацию

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

Обновление не продлевает обычный срок в 48 часов. До 50 MiB на превью, до 3 активных превью на IP. Клиенту не нужен ключ управления; отправляйте только ссылку просмотра.

Ещё по теме