Las páginas no se almacenan en caché

Si Cache Contents permanece en cero o la misma URL nunca produce un acierto verificado, localiza la primera condición fallida de esta secuencia.

1. Usa una solicitud de prueba válida

Empieza con una página publicada normal y solicítala dos veces desde una ventana privada del navegador.

La solicitud debe:

• usar GET o HEAD;
• no tener cuerpo de solicitud;
• usar el host canónico y el enlace permanente del sitio;
• no tener parámetro de vista previa o del Personalizador;
• no contener una cadena de consulta significativa;
• no contener ninguna cookie de omisión de inicio de sesión de WordPress, de sesión/carrito de WooCommerce, de contraseña o de autor de comentarios;
• solicitar HTML, no un tipo de medio tipo JSON.

POM Cache elimina solo los parámetros configurados de solo seguimiento. Cualquier otro parámetro de consulta mantiene dinámica la solicitud HTML. No clasifiques un parámetro como dato de seguimiento a menos que nunca pueda alterar la respuesta pública.

2. Confirma los requisitos previos de WordPress

Abre Settings → Permalinks y asegúrate de que el sitio tenga una estructura de enlaces permanentes personalizada no vacía. POM Cache informa de Permalink structure error cuando no puede usar la asignación de URL requerida.

Después abre Settings → POM Cache → General y confirma que el motor de caché HTML estática está habilitado.

En multisitio, verifica que estás configurando y probando el mismo sitio y host.

3. Revisa la configuración inicial

Abre Settings → POM Cache → Advanced → WordPress configuration. Todo lo siguiente debe ser correcto:

• el drop-in detectado coincide con el origen de POM Cache;
• POM_CACHE_HOME tiene la ruta esperada;
• WP_CACHE está definido como true.

General → Cache tools → Configuration → Fix Configuration repara los archivos de ajustes generados de POM Cache, pero no modifica el drop-in ni wp-config.php. Sigue advanced-cache.php is not loaded para realizar cambios manuales.

4. Asegúrate de que la ruta sea apropiada

POM Cache rechaza la caché HTML normal por URL para:

• la administración de WordPress y las rutas PHP internas;
• las solicitudes REST;
• los feeds, los sitemaps y las respuestas de robots;
• las redirecciones;
• las vistas previas y las solicitudes del Personalizador;
• las cabeceras Accept de tipo JSON;
• los contextos de página desconocidos de forma predeterminada;
• las respuestas 404, que usan el documento compartido independiente después de que WordPress resuelva la solicitud;
• las solicitudes donde DONOTCACHEPAGE está definido;
• las respuestas que siguen a un error fatal de PHP.

Usa una página singular correcta y normal para la primera prueba. Una vez que funcione, diagnostica las rutas especiales por separado.

5. Comprueba la respuesta completada

La respuesta debe ser no vacía y contener un marcador de finalización reconocido. El HTML normal debe alcanzar su etiqueta de cierre del documento. Un error fatal de PHP, un renderizado interrumpido o una salida anticipada pueden mostrar contenido parcial en un navegador, pero aun así se rechazan correctamente para la caché.

Inspecciona:

• el estado HTTP;
• Content-Type;
• el cuerpo de respuesta completo;
• los registros de PHP y del servidor web;
• las redirecciones inesperadas;
• los plugins o el código del tema que definen DONOTCACHEPAGE.

6. Comprueba el almacenamiento

Actualiza Settings → POM Cache → General después de la primera solicitud. Si el recuento de HTML no cambia:

• confirma que la ubicación de caché configurada existe o puede crearse;
• verifica que PHP puede escribir allí;
• comprueba el espacio del sistema de archivos y los inodos;
• comprueba que los filtros de ruta no hayan hecho que las fases inicial y de WordPress discrepen.

No soluciones los permisos haciendo que el árbol de caché sea escribible globalmente. Usa la propiedad y los permisos recomendados por tu entorno de alojamiento.

7. Demuestra la reutilización

Después de la generación, solicita de nuevo la URL idéntica. Un acierto servido por PHP puede mostrar:

X-POM-Cache: Served static cache from PHP; phase=early

Un acierto directo de Apache no tendrá necesariamente esa cabecera. Consulta Verify a cache hit.

Si los archivos se generan pero nunca se reutilizan, inspecciona las cookies, el host, la ruta, la regla del servidor directo y la asignación de ubicación de caché de la solicitud. Si el origen acierta correctamente pero el nombre de host público no, diagnostica la CDN por separado.