Solucionar problemas de optimización de imágenes

Empieza con un único adjunto y distingue los problemas de subida, optimización, metadatos y entrega. Que falte una respuesta WebP no es necesariamente un fallo de optimización si la imagen compañera existe, pero el servidor web nunca la selecciona.

La subida termina pero no aparecen ahorros

Comprueba que:

  • el adjunto sea JPEG, PNG, GIF, AVIF o WebP;
  • el módulo estuviera habilitado antes de que se generaran los metadatos;
  • el archivo de origen sea legible y su directorio tenga permisos de escritura;
  • Imagick o GD puedan decodificar el origen;
  • las dependencias de la imagen y del optimizador estén presentes;
  • el adjunto no estuviera ya marcado como optimizado.

Usa Media → Image optimizer → Optimize all images solo después de confirmar que es aceptable volver a procesar el origen.

Un adjunto muestra un error

El módulo trata el procesamiento como un posprocesamiento opcional. Si la optimización del origen falla, deja el archivo de origen y sus metadatos sin cambios. Si el origen se procesa bien pero una conversión WebP posterior falla, el origen validado permanece optimizado con sus metadatos coincidentes, y se conserva cualquier imagen compañera WebP anterior. Corrige el problema indicado de sistema de archivos, controlador de imágenes, imagen malformada u optimizador y, después, vuelve a intentarlo con Optimize missing images.

Confirma que el archivo principal es legible antes de reintentar. Si el archivo está vacío o dañado, restáuralo primero desde la copia de seguridad.

Faltan tamaños esperados

Image Optimizer elimina intencionadamente medium_large, 1536x1536 y 2048x2048 de la lista de tamaños generados. También elimina las variantes obsoletas asociadas al adjunto tras la regeneración.

Para cualquier otro tamaño que falte:

  1. confirma que el tema o el plugin lo registra antes de que se generen los metadatos del adjunto;
  2. inspecciona las dimensiones de la imagen: WordPress no crea una derivada ampliada;
  3. regenera el adjunto de prueba;
  4. verifica que sus metadatos y sus archivos coinciden.

WebP existe pero los visitantes reciben JPEG o PNG

Image Optimizer no realiza negociación de contenido. Inspecciona la regla de la CDN o del servidor web, la respuesta Content-Type, la clave de caché, la gestión de Accept y la alternativa al formato original.

La página de procesamiento masivo se detiene

Mantén la página abierta, corrige el primer problema de adjunto indicado y vuelve a ejecutar Optimize missing images. Los adjuntos completados conservan su marcador; los incompletos siguen siendo aptos. Si un proxy o una capa de seguridad bloquea las peticiones AJAX de administración, permite el flujo normal de administración autenticada de WordPress en lugar de exponer la operación públicamente.