WebP no se sirve

POM Cache no genera imágenes WebP. Su enfoque opcional de Apache puede reescribir una petición de imagen original hacia una alternativa WebP en la misma carpeta cuando esa alternativa ya existe y el cliente anuncia compatibilidad con WebP.

Por ejemplo, una petición de:

/uploads/2026/07/dish.jpg

puede usar:

/uploads/2026/07/dish.jpg.webp

La original sigue siendo la alternativa de respaldo.

Confirma que existe el archivo WebP

Comprueba que:

• la imagen original existe;
• la alternativa .webp existe en el mismo directorio;
• su nombre incluye el nombre de archivo original completo y su extensión antes de .webp;
• Apache puede leer ambos archivos;
• el archivo WebP es una imagen válida.

POM Cache no creará una alternativa que falte. Usa el flujo de procesamiento de imágenes del sitio para generarla.

Prueba la negociación de contenido

En el panel Network del navegador, inspecciona la petición de la imagen. La cabecera Accept de la petición debe incluir compatibilidad con WebP.

Compara una petición que acepta WebP con otra que no. La primera debería recibir bytes WebP y la segunda debería recibir el formato original. Confirma el Content-Type real, no solo la URL o el nombre de archivo.

El servidor necesita la correspondencia MIME de WebP correcta:

image/webp

Verifica la regla de Apache

Confirma que la regla instalada:

• está activa para el directorio de cargas y el host virtual;
• se ejecuta antes de las reglas alternativas de WordPress;
• comprueba la capacidad WebP del cliente;
• comprueba que el archivo .webp en la misma carpeta existe;
• reescribe internamente sin cambiar la URL pública de la imagen;
• conserva la original cuando falla cualquier condición.

Valida la sintaxis de Apache después de editar. POM Cache no puede actualizar una regla de servidor copiada solo porque haya cambiado un ajuste de WordPress.

Conserva Vary: Accept

Como la URL pública puede devolver WebP o los bytes originales, las cachés intermediarias necesitan distinguir la negociación. Confirma que la respuesta incluye un adecuado:

Vary: Accept

y que la política de caché del CDN respeta la estrategia de variación elegida.

Sin una variación correcta, un cliente que no admite WebP puede recibir WebP o un cliente compatible con WebP puede seguir recibiendo la original.

Prueba sin el CDN

Demuestra primero la reescritura en el origen. Si el origen funciona pero CloudFront no:

• revisa el comportamiento para las rutas de medios;
• revisa si Accept participa en la política de reenvío o de clave de caché;
• invalida la URL exacta de la imagen después de crear la alternativa .webp;
• inspecciona el estado de caché de borde y el Content-Type de la respuesta.

CloudFront también puede llevar a cabo su propio comportamiento de imagen o compresión dependiendo de la plataforma más amplia. Asegúrate de que solo una capa documentada controle la negociación de formato.

Alternativa de respaldo esperada

Devolver el archivo original es correcto cuando:

• el navegador no anuncia WebP;
• la alternativa no existe;
• la regla de reescritura no está desplegada para esa ruta;
• fallan las comprobaciones de archivo o de MIME.

No dejes la original indisponible. Una alternativa de respaldo elegante protege a los clientes no compatibles y evita medios rotos mientras la generación de WebP está incompleta.