Caché HTTP para actualizar un sitio estático sin mezclar versiones
Separa las páginas HTML de los recursos cuyo nombre cambia con el contenido. El HTML debe poder descubrir una publicación reciente. Una hoja de estilo con un nombre ligado a su versión se puede conservar durante más tiempo. Para probarlo, publica dos variantes en un entorno de pruebas y comprueba qué recibe una persona que visitó la primera antes de que saliera la segunda.
Dibuja el recorrido de una visita
Una página puede llegar desde el servidor original o desde un intermediario. El navegador también puede reutilizar una respuesta que ya tiene. Lee los encabezados de la petición y la respuesta para distinguir comportamientos. Apunta el estado HTTP y cualquier indicador de caché que proporcione tu servicio. Tener una copia antigua en una capa no implica que todas las demás estén entregando lo mismo.
Antes de cambiar un encabezado, abre la dirección en una sesión nueva y vuelve a abrirla en una sesión que ya haya visitado el sitio. Usa el mismo dominio y la misma ruta. Si los resultados difieren, identifica primero qué recurso quedó antiguo. Una página nueva puede apuntar a un archivo de estilos con el mismo nombre y mostrar aún la copia anterior. Resolver esa mezcla requiere revisar ambas respuestas.
Trata de forma distinta el documento y los archivos versionados
Para CSS e imágenes cuya URL incluye una versión, genera otra dirección al cambiar sus bytes. La página nueva debe apuntar a esa dirección. Deja disponible el archivo anterior mientras pueda circular HTML que lo referencia. En cambio, si el documento está siempre en la misma URL, planifica una forma de comprobar si sigue vigente. La guía de caché HTTP de MDN explica la diferencia entre conservar una copia y validarla.
Si eliges la directiva no-cache, comprueba que entiendes su significado: permite reutilizar una respuesta tras validarla. La directiva no-store tiene otro fin y evita el almacenamiento según las condiciones descritas en la documentación HTTP. Elige según el tipo de contenido. En un sitio público de lectura, probar la validación del documento y la reutilización de recursos suele ser más útil que desactivar la caché en todo el sitio.
Comprueba una publicación de principio a fin
En la primera versión deja una diferencia fácil de reconocer en el título y en la hoja de estilo. Visita esa versión y conserva la sesión. Publica el HTML con la nueva referencia y comprueba que el segundo archivo responde antes de retirar el anterior. Vuelve a la sesión usada al principio y recarga normalmente. Anota qué versión del documento y qué recurso obtuvo el navegador.
Si el HTML es correcto y la apariencia coincide con la publicación antigua, compara el nombre de la referencia, la respuesta del archivo y el origen que la entregó. Si falta el recurso nuevo, revisa el orden de la subida. Un archivo publicado después del HTML crea un periodo durante el cual la página puede quedar sin estilo. Sube primero los recursos y luego activa el documento que los usa.
Deja un camino de recuperación
Conserva la versión anterior y su lista de recursos. Así puedes volver a publicarla sin depender de que todas las copias intermedias hayan cambiado de inmediato. Es útil guardar una breve prueba: abrir la portada, cargar un artículo y confirmar el nombre de la hoja de estilo. Tras la siguiente publicación repite la comprobación desde una sesión con caché y otra nueva.