Progressive JSON no se actualiza

La frescura de Progressive JSON depende de cuatro etapas: generación, escritura, lectura desde el origen y entrega externa. Identifica qué etapa conserva todavía el valor antiguo.

Encuentra la solicitud JSON real

Abre el panel Network del navegador, reproduce la interacción de archivo o búsqueda facetada y selecciona la solicitud que devuelve los datos.

Registra:

• URL de la solicitud saneada;
• estado y tipo de contenido;
• campo del cuerpo de la respuesta que está obsoleto;
• X-POM-Cache o X-POM-Progressive-Archive-Cache;
• estado de CDN y cabeceras de edad;
• si el mismo valor aparece en el HTML inicial.

Si el navegador nunca realiza una solicitud progresiva, diagnostica el comportamiento del maquetador de páginas o del front-end antes que la caché JSON.

Confirma los ajustes en tiempo de ejecución

Abre Settings → POM Cache → General y revisa el tiempo de ejecución de Progressive JSON:

• el maestro de JSON debe estar activado;
• las escrituras deben estar activadas para crear nuevos artefactos;
• la alternativa de lectura de WordPress debe estar activada para las lecturas cacheadas a través de WordPress.

La lectura directa opcional de Apache es una capa de despliegue independiente. Una alternativa de WordPress desactivada no demuestra que una regla de Apache instalada esté inactiva.

Comprueba la generación y la escritura

Limpia Progressive JSON Cache para el sitio actual y, a continuación, solicita la ruta afectada.

Solo se escribe un archivo nuevo cuando:

• el productor proporciona una ruta .json relativa segura;
• el payload es JSON válido y no vacío dentro del tamaño máximo;
• el contexto de generación lo marca como cacheable;
• el filtro de escritura lo permite;
• el destino admite escritura.

Actualiza Progressive JSON Cache Contents. Si el recuento sigue siendo cero, inspecciona la generación, la validación de la ruta, la cacheabilidad, el tamaño máximo y los permisos. El recuento de archivos HTML no está relacionado.

Interpreta las cabeceras de respuesta

Un acierto temprano de JSON PHP informa:

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

Un acierto de caché POM Theme de la alternativa de WordPress puede informar:

X-POM-Progressive-Archive-Cache: hit

La generación puede informar generated-cacheable o generated-dynamic. Un valor dinámico significa que la respuesta se omitió deliberadamente de la persistencia.

Un acierto directo de Apache no tiene ninguna cabecera de diagnóstico generada por PHP. Verifícalo en la capa del servidor web.

Comprueba la invalidación

Progressive JSON tiene ajustes de purga independientes para cambios de entradas, términos y traducciones. La purga por cambios de ajustes es una integración de desarrollador opcional.

Prueba el cambio exacto:

1. calienta la ruta JSON;
2. edita el origen;
3. observa si se eliminan los archivos JSON;
4. vuelve a solicitarla;
5. confirma que el cuerpo regenerado contiene el cambio.

Un importador personalizado, una sincronización de API o una actualización de tabla personalizada deben llamar a un asistente público de purga de JSON después de que su transacción se complete correctamente. No limpies una vez por elemento en un trabajo por lotes.

Comprueba las variantes de clave

La configuración regional, el tipo de entrada, la paginación y el contexto de filtro público pueden generar rutas diferentes. Asegúrate de limpiar y solicitar la misma variante. Un slug o formato de clave modificado puede dejar un árbol antiguo hasta que se limpie el almacén de JSON del sitio actual.

Termina con Apache, CDN y navegador

Una vez que la respuesta de origen de PHP es actual:

• verifica que la regla de Apache apunte al mismo archivo;
• invalida los objetos exactos de CloudFront;
• vuelve a probar con el estado en el borde y las cabeceras de edad;
• excluye la caché del navegador, los service workers y el almacenamiento del lado del cliente.

No amplíes las rutas JSON ni almacenes en caché respuestas de API personalizadas como una solución alternativa a una invalidación omitida.