#Суть неисправности и признаки
Исходное изображение в формате WebP видно в медиатеке WordPress, однако уменьшенные варианты (thumbnail, medium, large или размеры темы) отсутствуют либо отображаются битые изображения. При загрузке исходный файл может сохраниться успешно, даже когда серверный обработчик не умеет подготовить уменьшенные копии. Проверяйте сначала один конкретный файл и возможности библиотеки GD/Imagick в той версии PHP, которая действительно обслуживает сайт. Не меняйте разрешения всего каталога на 777 и не удаляйте исходные изображения.
#Почему возникает проблема
| Возможная причина | Как узнать | Что делать |
|---|---|---|
| Нет полноценной поддержки WebP у обработчикаРасширение GD или Imagick установлено, но собрано без необходимых возможностей декодирования WebP. | JPEG даёт размеры, а WebP — только оригинал; в «Здоровье сайта» есть сведения о медиасреде. | Проверить GD/Imagick для веб-обработчика PHP и попросить хостинг подключить поддержку. |
| Нехватка памяти или ограничение процессаБольшой файл при декодировании может потребовать существенно больше памяти, чем занимает на диске. | В журналах PHP появляется memory exhausted или исключение библиотеки обработки. | Определить потребление и уменьшить тестовое изображение, не повышая лимиты без расчёта. |
| Нельзя записать производные файлыПрава владельца каталога uploads либо дисковая квота мешают создавать миниатюры. | Оригинал загружается, но при генерации возникает предупреждение записи. | Сверить владельца каталога, свободное место и ограничения. |
| Плагин или тема изменили размеры/форматФильтры image_editor_output_format или промежуточные размеры влияют на генерацию. | Без конкретного плагина на тестовой копии миниатюры создаются. | Изолировать конфликт без отключения защиты публичного сайта. |
#Пошаговая диагностика и устранение
- Выберите один проблемный WebP и сохраните оригиналОткройте «Медиафайлы» → «Библиотека», выберите недавно загруженную картинку WebP и запишите её название и размер. Скачайте оригинал из карточки файла или через панель файлов и сохраните локально. Зафиксируйте, какие размеры отсутствуют в записи или теме. Не удаляйте объект из медиатеки: вместе с ним могут исчезнуть связи с публикациями.
- Проверьте, воспроизводится ли проблема на обычном JPEGВозьмите два собственных небольших тестовых изображения с одинаковыми размерами — JPEG и WebP. В медиатеке выберите «Добавить новый медиафайл», загрузите каждый и откройте карточку. Если у JPEG появились уменьшенные варианты, а у WebP нет, подозревайте поддержку формата; если не работают оба, проверьте запись, память и плагины. Удаление тестов допустимо только если точно установлено, что они нигде не используются.
- Проверьте серверную среду из WordPressВ админке откройте «Инструменты» → «Здоровье сайта» → «Информация» и разверните «Обработка медиафайлов» или близкий по смыслу раздел о медиабиблиотеках. Просмотрите версии Imagick/GD и поддержку форматов, если показана. Из-за версии WordPress названия отдельных полей могут различаться; отсутствие списка WebP ещё не доказывает запрет — подтвердите результат пробной загрузкой и журналом PHP.
- Убедитесь, что проверяется нужный PHPВ панели хостинга откройте настройки именно этого домена, посмотрите режим и версию PHP, затем доступные модули. Проверка «php -m» по SSH может относиться к другой версии CLI. Попросите хостинг подтвердить поддержку WebP у расширений для PHP-FPM, если нет доступа к управлению модулями. Не переключайте обработчик работающего сайта только ради одной картинки.
- Найдите сбой в журнале загрузкиЗафиксируйте точное время тестовой загрузки. В панели сайта откройте журнал ошибок PHP и веб-сервера; ищите сообщения Imagick, GD, insufficient memory, Permission denied или disk full. Если логи пустые, попросите хостинг проверить журнал соответствующего пула PHP-FPM. Запишите только техническую ошибку без закрытых путей и данных пользователей.
- Проверьте каталог uploads и ресурсыЧерез файловый менеджер панели найдите wp-content/uploads и каталог текущего года/месяца, где лежит исходный файл. Убедитесь, что серверный пользователь имеет право создавать рядом файлы и свободно место по квоте. Если был недавний перенос между пользователями, исправляйте владельца только конкретного каталога по инструкции вашей панели; массовые права 777 недопустимы.
- Восстановите одну миниатюру после устранения причиныЕсли WP-CLI уже установлен и есть резервная копия оригинала и файлов медиатеки, найдите идентификатор вложения через медиатеку или команду поиска WP-CLI и выполните для одного подтверждённого ID регенерацию с --only-missing и --skip-delete. Команда ниже использует 123 только как пример идентификатора вложения; обязательно замените его на свой. Она создаёт новые файлы и изменяет метаданные, поэтому сначала проверьте на копии.
- Проверьте размеры на сайте и не повторяйте массовую операциюОбновите страницу записи, где используется проблемное изображение, и посмотрите в браузере, отдаётся ли подходящий файл без 404. Если тестовый файл прошёл, а старые не восстановились, повторно диагностируйте их кодирование и размеры. Массовую регенерацию медиатеки запускать нельзя до оценки места, резервной копии и проверки нескольких разных файлов.
- Запуск в SSH из каталога WordPress под пользователем сайта при наличии WP-CLILinux · Терминал (Bash)С осторожностьюЗапуск в SSH из каталога WordPress под пользователем сайта при наличии WP-CLI. Замените 123 на настоящий ID вложения; команда изменяет файлы и метаданные изображения, поэтому только после копии и устранения ошибки.
wp media regenerate 123 --only-missing --skip-deleteКоманда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.
#Как проверить результат и что делать, если не помогло
Успех: WordPress создаёт отсутствующие размеры тестового WebP, новая миниатюра загружается по HTTPS и страница больше не запрашивает отсутствующий файл. Если исходный WebP открывается, но генерация по-прежнему падает, передайте хостингу версию PHP-FPM, информацию GD/Imagick, точное время теста и строки журнала. Не называйте ошибку исключительно «недостаточно памяти» без подтверждения.