Loading...

Ayuda de CDN.com.tr

Claves de caché y purga: por qué ocurre "purgué pero sigue viejo"

Cada objeto en caché se almacena bajo una clave construida a partir de la solicitud: esquema, host, ruta y cadena de consulta. Una purga solo elimina una entrada cuando apunta exactamente a esa clave. Entender esta única idea explica casi todos los casos de "la purga no funcionó".

Claves de caché y purga: por qué ocurre "purgué pero sigue viejo"

Cada objeto en caché se almacena bajo una clave construida a partir de la solicitud: esquema, host, ruta y cadena de consulta. Una purga solo elimina una entrada cuando apunta exactamente a esa clave. Entender esta única idea explica casi todos los casos de "la purga no funcionó".

Herramientas y lecturas relacionadas

Los dos temas del panel en los que se apoya este, y la versión en guía con ejemplos de API y cdnctl.

Leer los encabezados de estado de caché

HIT, MISS, BYPASS, EXPIRED — la mitad de diagnóstico de este flujo de trabajo.

Abrir el tema

Purgar contenido en caché

El recorrido por Purge Management: purga por ruta, rutas guardadas, purge all.

Abrir el tema

Guía de purga de caché del CDN

El mismo modelo mental en profundidad, con llamadas a la API y comandos de cdnctl de una línea para scripts de despliegue.

Leer la guía

Ruta en el panel

  1. Panel de administración
  2. Cuentas CDN
  3. Purge Management

Requisitos previos

  • La ruta debe pertenecer a la cuenta seleccionada.
  • Diagnostique con la URL pública exacta (esquema + host + ruta + consulta), no con un resumen de ella.

Casos de uso

Purgó una ruta después de una implementación, pero un visitante sigue reportando la versión antigua. En casi todos los casos la purga sí funcionó — solo que eliminó una entrada de caché distinta de la que se le está sirviendo al visitante (una variante con cadena de consulta, la copia móvil o el propio caché de su navegador).

Flujo de trabajo

  1. Obtenga la URL exacta que el visitante ve desactualizada — incluyendo el esquema (https), el host (www o apex) y cualquier cadena de consulta. "La página de productos" no es suficiente; /products y /products?page=2 son entradas de caché diferentes.
  2. Verifique qué hizo realmente el CDN: ejecute `curl -I` contra esa URL exacta y lea `X-Proxy-Cache-MT`. HIT significa que el CDN sirvió una copia en caché; MISS o BYPASS significa que el CDN no es lo que está sirviendo el contenido antiguo.
  3. Purgue con el alcance que corresponde al problema en Purge Management: una única ruta exacta para una URL, una purga de carpeta para todo lo que está bajo una ruta, o una purga de toda la cuenta cuando la estructura cambió en todas partes.
  4. Verifique de la misma forma en que diagnosticó: solicite de nuevo la URL exacta y espere MISS (fresco desde el origen) y luego HIT. Si su propio navegador sigue mostrando la página antigua, haga una actualización forzada — el CDN no puede alcanzar los cachés de los navegadores.

Verificaciones

  • Las cadenas de consulta crean entradas separadas: /banner.jpg y /banner.jpg?v=2 se almacenan en caché de forma independiente. Purgar una no toca la otra.
  • El esquema y el host forman parte de la clave: http vs https y www vs apex son entradas diferentes. Purgue la forma canónica que sus visitantes usan realmente.
  • Móvil y escritorio pueden ser copias separadas de la misma ruta — un reporte de contenido desactualizado solo desde teléfonos suele ser la variante móvil.
  • Una purga limpia el CDN, nunca el caché del navegador de un visitante. Lo que limita esa última ventana es el TTL de navegador en sus reglas de caché, no otra purga.

Preguntas frecuentes

La purga indicó éxito, pero la página sigue vieja — ¿falló?

Casi con toda seguridad no. Diagnostique con `curl -I` contra la URL exacta: si ve MISS en la primera solicitud después de la purga, la entrada del CDN sí se eliminó y la copia desactualizada está en otro lugar — otra variante de la URL, o el caché del navegador del visitante.

Purgué /products pero /products?page=2 y /products?utm_source=x siguen viejos.

Cada combinación de cadena de consulta es su propia entrada de caché. Purgue la carpeta/prefijo para que se eliminen todas las entradas bajo la ruta, o purgue explícitamente las variantes más frecuentes.

¿Necesito purgar después de cada implementación?

Si su HTML se almacena en caché con un TTL largo, sí — purgue las rutas modificadas como un paso de la implementación. La API de purga y cdnctl existen exactamente para esto; un script de despliegue que termina con una purga con alcance definido nunca tiene esta clase de problema.

¿Cuándo debo usar "purge all"?

Cuando la estructura de URLs cambió en todo el sitio (una migración, un rediseño) y las purgas por ruta serían una larga lista de suposiciones. Úselo de forma deliberada: justo después, cada solicitud es un MISS hasta que el caché se vuelve a calentar, así que su origen recibe brevemente todo el tráfico.