Расширение .webp не доказывает формат. Возьмите один проблемный URL, сохраните заголовки и первые байты ответа. Настоящий WebP использует контейнер RIFF и содержит идентификатор WEBP; если вместо него начинается HTML, сервер вернул страницу ошибки или fallback приложения под адресом картинки.

Проверяйте origin и публичный CDN отдельно. Ответ должен иметь успешный статус, ненулевой ожидаемый размер и Content-Type image/webp. Если origin исправен, а CDN отдаёт старый 404, неверный type или обрезанный объект, изменение разметки не поможет до обновления кеша или ключа файла.

Симптом указывает на разный участок

Что видноВероятная причинаСледующий тест
Decode errorФайл обрезан или это не WebPRIFF/WEBP header и decoder
200, но Content-Type text/htmlSPA или error fallbackСравнить body и server route
Браузер предлагает скачатьapplication/octet-stream или attachmentContent-Type и Content-Disposition
Только CDN показывает староеКеш по прежнему URLAge, ETag и origin response
Один вариант picture пустойНеверный srcset или mediaПрямой URL каждого source

Формат подтверждается декодером

response = GET imageUrl
assert response.status == 200
assert response.headers["Content-Type"] == "image/webp"
assert response.body[0:4] == "RIFF"
assert response.body[8:12] == "WEBP"
decodeWithReferenceWebpLibrary(response.body)

Сигнатура быстро отсеивает HTML и переименованный JPEG, но окончательную целостность подтверждает декодирование. Reference tools libwebp включают dwebp для чтения WebP. Не принимайте файл только по расширению при загрузке: проверяйте разрешённый формат, размеры и лимиты до сохранения.

MIME задаётся сервером по реальному типу

Спецификация WebP указывает MIME type image/webp. Добавьте соответствие в конфигурацию раздачи файлов и проверьте итоговый ответ после include. Не подменяйте type через query-параметр от пользователя. Content-Disposition attachment уберите для изображений, которые должны отображаться inline.

Picture даёт управляемый fallback

<picture>
  <source srcset="/media/product-42.webp" type="image/webp">
  <img src="/media/product-42.jpg" width="800" height="600"
       alt="Название товара" loading="lazy">
</picture>

Откройте каждый URL из srcset напрямую: относительный путь вычисляется от адреса документа, а не от шаблона на сервере. width и height уменьшают скачок макета, но должны соответствовать соотношению сторон. Alt описывает изображение и не служит сообщением о технической ошибке.

Кеш связывается с содержимым

  • Хэшированный filename меняется после новой конвертации.
  • Origin и CDN возвращают одинаковый Content-Type для одного объекта.
  • 404 не кешируется дольше, чем позволяет процесс публикации.
  • При content negotiation ответ содержит корректный Vary и отдельные cache variants.
  • Удаление JPEG fallback выполняется только после измеренной поддержки нужной аудитории.

Если WebP перегенерирован под прежним URL, браузер и CDN могут продолжать показывать дефектную версию. Предпочтительнее новый content hash, чем массовый purge. Для пользовательских файлов храните версию производной рядом с записью, чтобы все карточки получили новый адрес согласованно.

Регресс проверяется на разных свойствах файла

  1. Открыть lossy и lossless WebP, вариант с alpha и анимацию, если она разрешена продуктом.
  2. Проверить прямой URL, picture и CSS background-image.
  3. Запросить файл через origin и CDN и сравнить статус, type, size и checksum.
  4. Проверить 404 на несуществующий файл без HTML с кодом 200.
  5. Открыть страницу на целевых браузерах продукта без расширений.
  6. Повторить после deploy и очистки старого release.

Для диагностики достаточно URL, response headers, первых 12 байт или checksum, команды конвертации и HTML-фрагмента. Само клиентское фото лучше заменить синтетическим тестом с теми же свойствами — так проверка не раскрывает личное изображение.

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