Lista de comprobación de diagnóstico de POM Cache

Usa esta lista de comprobación después de la instalación, de un despliegue, de un cambio de enlaces permanentes o de un aviso que indique que el almacenamiento en caché ha dejado de funcionar. Sigue el orden: primero la configuración, segundo la generación, tercero la entrega y por último la invalidación.

1. Confirma el contexto de la prueba

• [ ] Estás administrando el sitio y el servidor previstos.
• [ ] La prueba pública usa una ventana privada o un cliente limpio.
• [ ] La solicitud es GET o HEAD.
• [ ] La URL no tiene vista previa, personalizador ni ningún parámetro de consulta significativo.
• [ ] La solicitud no contiene cookies de inicio de sesión, carrito, contraseña, autor de comentarios u otras cookies de omisión.
• [ ] Sabes si el síntoma afecta al HTML, al JSON progresivo, a Apache, a una CDN o a WebP.

2. Comprueba los requisitos previos de WordPress

• [ ] WordPress usa una estructura de enlaces permanentes personalizada y no vacía.
• [ ] El interruptor maestro correspondiente de HTML o de JSON progresivo está activado.
• [ ] La ruta solicitada es pública y apropiada para el almacenamiento en caché compartido.
• [ ] Al probar HTML, la respuesta no es una solicitud de administración, REST, robots, feed, mapa del sitio, redirección o de tipo JSON.
• [ ] La prueba HTML ordinaria usa una página existente. Prueba el documento 404 compartido por separado con los pasos de verificación del 404.

3. Revisa la configuración inicial

Abre Settings → POM Cache → Advanced → WordPress configuration.

• [ ] Drop-in está marcado como OK y coincide con el código fuente proporcionado por el plugin.
• [ ] POM_CACHE_HOME tiene el valor esperado.
• [ ] WP_CACHE está definido como true.
• [ ] Si los archivos de configuración generados resultaban sospechosos, General → Cache tools → Configuration → Fix Configuration se completó correctamente.

Recuerda que Fix Configuration no repara el drop-in ni wp-config.php.

4. Demuestra la generación

• [ ] Borraste únicamente el almacén relevante del sitio actual.
• [ ] La primera solicitud anónima devolvió una respuesta correcta y completa.
• [ ] La respuesta HTML contiene un marcador de finalización reconocido, como la etiqueta de cierre del documento HTML.
• [ ] La respuesta JSON es válida, no vacía, está dentro del límite de tamaño configurado y su productor la marca como almacenable en caché.
• [ ] La ubicación de la caché es escribible y dispone de espacio en disco suficiente.
• [ ] Al actualizar la pantalla de configuración se muestra el recuento esperado de archivos HTML o JSON.

5. Demuestra la reutilización

• [ ] Una segunda solicitud idéntica al origen devuelve la misma representación pública.
• [ ] Las cabeceras de acierto de PHP aparecen cuando PHP realiza la lectura.
• [ ] Si Apache sirve directamente, la evidencia a nivel de servidor demuestra la ruta del archivo estático.
• [ ] Una solicitud con sesión iniciada o personalizada se sigue gestionando de forma segura.

Consulta Verificar un acierto de caché para conocer los valores de las cabeceras y sus limitaciones.

6. Comprueba las capas de Apache y de la CDN

• [ ] Las reglas de Apache copiadas coinciden con la raíz de documentos real, el host, la ubicación de la caché y la forma de la ruta.
• [ ] Las reglas aparecen antes del bloque normal de reescritura de WordPress.
• [ ] Las reglas directas exigen el método esperado, una consulta limpia, cookies seguras y un archivo existente.
• [ ] El origen es correcto antes de cualquier invalidación de la CDN.
• [ ] Las claves de caché de la CDN y la negociación de compresión conservan las variantes necesarias.

7. Comprueba la vigencia

• [ ] El interruptor de purga automática apropiado está activado para el cambio de contenido que se está probando.
• [ ] Editar un elemento público elimina el almacén esperado del sitio actual.
• [ ] La siguiente solicitud regenera la representación actualizada.
• [ ] El JSON progresivo y el HTML se borran de forma independiente cuando solo cambió uno de ellos.
• [ ] Una invalidación de la CDN cubre los objetos públicos exactos después de la corrección del origen.

Conserva evidencia útil

Antes de borrar cachés repetidamente, guarda:

• la URL exacta saneada y los pasos de reproducción;
• las cabeceras de respuesta relevantes y el estado;
• los contadores de HTML y de JSON;
• el estado de configuración de WordPress;
• si el origen y la CDN difieren;
• las versiones del producto, de WordPress, de PHP y del servidor web.

Nunca compartas claves de licencia, cookies, cabeceras de autorización, cuerpos de respuesta privados, credenciales ni rutas absolutas innecesarias del servidor. Si la lista de comprobación identifica un síntoma concreto, continúa con la guía correspondiente en Ayuda y solución de problemas.