Расширение .webp не доказывает формат. Возьмите один проблемный URL, сохраните заголовки и первые байты ответа. Настоящий WebP использует контейнер RIFF и содержит идентификатор WEBP; если вместо него начинается HTML, сервер вернул страницу ошибки или fallback приложения под адресом картинки.
Проверяйте origin и публичный CDN отдельно. Ответ должен иметь успешный статус, ненулевой ожидаемый размер и Content-Type image/webp. Если origin исправен, а CDN отдаёт старый 404, неверный type или обрезанный объект, изменение разметки не поможет до обновления кеша или ключа файла.
Симптом указывает на разный участок
| Что видно | Вероятная причина | Следующий тест |
|---|---|---|
| Decode error | Файл обрезан или это не WebP | RIFF/WEBP header и decoder |
| 200, но Content-Type text/html | SPA или error fallback | Сравнить body и server route |
| Браузер предлагает скачать | application/octet-stream или attachment | Content-Type и Content-Disposition |
| Только CDN показывает старое | Кеш по прежнему URL | Age, 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. Для пользовательских файлов храните версию производной рядом с записью, чтобы все карточки получили новый адрес согласованно.
Регресс проверяется на разных свойствах файла
- Открыть lossy и lossless WebP, вариант с alpha и анимацию, если она разрешена продуктом.
- Проверить прямой URL, picture и CSS background-image.
- Запросить файл через origin и CDN и сравнить статус, type, size и checksum.
- Проверить 404 на несуществующий файл без HTML с кодом 200.
- Открыть страницу на целевых браузерах продукта без расширений.
- Повторить после deploy и очистки старого release.
Для диагностики достаточно URL, response headers, первых 12 байт или checksum, команды конвертации и HTML-фрагмента. Само клиентское фото лучше заменить синтетическим тестом с теми же свойствами — так проверка не раскрывает личное изображение.