Guías prácticas

Configure el almacenamiento en caché HTTP sin exponer datos privados

El almacenamiento en caché ayuda solo cuando la respuesta reutilizada es apropiada para el visitante y el momento del acceso. Una sola política para cada recurso puede ocultar una actualización o exponer una respuesta personalizada.

Ver el método

Ilustración — Configure el almacenamiento en caché HTTP sin exponer datos privados
Ilustración generada por IA

Clasifica las respuestas antes de elegir toda una vida

Inventario de páginas públicas, activos estáticos, respuestas API, cuentas y confirmaciones. Registre si cada uno cambia con el usuario, el idioma o un parámetro. Identificar cachés de navegador, intermediario y CDN. Una página de cuenta no debe heredar la política de una fotografía pública simplemente porque esa política es fácil de aplicar.

Distingue la frescura de la autorización para almacenar una respuesta. MDN explica que no-caché requiere revalidación, mientras que no-store solicita ningún almacenamiento. Privado restringe el almacenamiento a cachés privados. Una cookie por sí sola no hace que una respuesta sea privada automáticamente.

Planifica cómo se hace visible una actualización

Escriba una regla de actualización para cada familia. Para un archivo versionado, confirme que la nueva página solicita la nueva URL. Para una página pública con una dirección estable, describa la revalidación o la purga. Una larga vida sin un procedimiento de reemplazo solo mueve el problema al siguiente cambio de contenido.

Elija un ejemplo práctico: una corrección de precio, horario de apertura o un documento reemplazado. Registre cuando el origen cambia, luego inspeccione una sesión que ya ha visitado la página. Un nuevo navegador por sí solo no cubre a un visitante que recurre que retiene una respuesta anterior.

Durante la revalidación, el navegador puede enviar en If-None-Match el ETag de su copia guardada. Si la representación sigue coincidiendo, una respuesta 304 permite reutilizar el cuerpo conservado; no entrega un nuevo cuerpo de página. Si ha cambiado, una respuesta completa 200 puede entregar el contenido y su nuevo validador. Un código aislado no describe lo que finalmente ve el visitante.

Si la primera respuesta incluye Last-Modified, copia esa fecha tal cual en If-Modified-Since al hacer un segundo GET a la misma URL. Un 304 indica que la fecha de modificación del servidor no es posterior a la enviada. Si se sirven dos versiones en el mismo segundo, la fecha puede coincidir aunque haya cambiado el contenido. Usa un ETag que distinga las versiones cuando esa precisión sea importante. Si la petición incluye ambos campos condicionales, se evalúa primero If-None-Match y se ignora If-Modified-Since.

La tabla utiliza los validadores ficticios demo-v1 y demo-v2 para distinguir etapas, sin medir este sitio. Conserve juntos petición condicional, respuesta, copia reutilizada y corrección mostrada. Un ETag es un identificador opaco generado por el servidor, no necesariamente una huella o fecha. Compruebe también Atrás: el historial puede restaurar una instantánea mediante un mecanismo distinto de la caché HTTP.

Desplace la tabla horizontalmente para leer todas las columnas. Con el teclado, sitúe el foco en la tabla y use las flechas.

Ejemplo ficticio: seguir la revalidación hasta el contenido mostrado
Situación de pruebaIntercambio que relacionarPrueba útil
Primera lectura200 con cuerpo y ETag demo-v1.La copia inicial contiene la versión esperada.
Revalidación sin cambiosIf-None-Match demo-v1 y después 304.Se reutiliza el cuerpo guardado; no se recibe uno nuevo.
Representación modificadaIf-None-Match demo-v1 y después 200 con demo-v2.Se recibe el nuevo cuerpo y la corrección resulta visible.
Respuesta 304 observada aisladamenteDebe relacionarse con la copia conservada.El código por sí solo no demuestra recuperación del contenido ni visualización de la variante correcta.

Pruebe diferentes identidades y estados

En un entorno de prueba, compare una visita anónima, dos cuentas distintas, cierre de sesión y navegación trasera. Inspeccione el contenido mostrado y los encabezados recibidos en lugar de solo la configuración de alojamiento. Use registros de prueba sintéticos en lugar de documentos personales reales.

Incluya estados relevantes de idioma, dispositivo, filtro y error. Mantenga la URL, el estado de la sesión, la respuesta esperada y el resultado para cada prueba. Cuando la personalización pasa a través de una memoria caché compartida, haga que el propietario de la infraestructura revise las claves de caché y las exclusiones.

Mantener un procedimiento de recuperación

Documente quién puede purgar el caché, verificar su efecto y restaurar una configuración anterior. Una purga amplia puede reducir temporalmente los beneficios del almacenamiento en caché, así que prepare una verificación de las páginas esenciales después de la operación.

Revise la política cuando se introduzcan cuentas de clientes, comercio, un idioma o una CDN. Un entregable útil es una matriz de respuesta-política-prueba-propietario. Una puntuación de rendimiento por sí sola no establece frescura ni aislamiento entre los usuarios.

Documentación principal: MDN: almacenamiento en caché HTTP.

Evitar que una caché compartida entregue la variante equivocada.

Caso ficticio: una URL entrega dos formatos según una cabecera. Pruebe ambos detrás de la caché real y su clave de variación, incluido Vary cuando corresponda. Las ediciones editoriales pueden necesitar URL distintas. La negociación no debe bloquear una versión elegida explícitamente.

  • Cada solicitud recibe su variante correcta, incluso después de la otra y con caché activa.
  • MDN Content Negotiation

    Guía de selección de representaciones HTTP por idioma, formato, codificación o capacidades del cliente.

Separar respuestas personales en caché

Dos portátiles diferenciados por marcas de colores junto a un router
Ilustración generada por IA · Observe el contenido por separado en dos sesiones de prueba.

Caso propuesto: una confirmación personal pasa por una caché compartida. Se necesita comprobar qué recibe cada sesión.

Use dos sesiones de prueba aisladas. Compare solicitudes, cabeceras y contenido; una configuración general no demuestra por sí sola la separación observada.

  • Abrir dos sesiones aisladas
  • Comparar cabeceras y contenido
  • Registrar la separación observada

Documentos de referencia

Contenido actualizado

Referencias documentadas para este tema

Referencias documentadas para este tema
ReferenciaValor o sintaxisAlcance
HTTP · 304
If-None-Match → 304En una solicitud GET o HEAD, una representación sin cambios puede reutilizarse sin reenviar su cuerpo.
MDN · Vary
Vary: Accept-LanguageSi una URL produce respuestas distintas según Accept-Language, Vary indica ese criterio a la caché. Mantenga un valor coherente en las respuestas 200 y 304. Las URL separadas por idioma no requieren esta cabecera solo por ser un sitio multilingüe.
HTTP · If-Match
If-Match: "r7" → 412If-Match compara un validador fuerte antes de escribir. En el contrato ilustrado, una versión antigua recibe 412; se conserva el borrador para comparar cambios.

Las fechas indican la consulta de las referencias. Estos datos no constituyen una auditoría ni una declaración global de conformidad.

Leer una revalidación de caché

Compare un cuerpo nuevo y una copia reutilizada. Los fragmentos muestran validadores y contenido disponible, además del código.

Los fragmentos son incompletos y usan direcciones de demostración. La prueba crea una Response en memoria: no contacta servidores ni simula red, caché o tratamiento de negocio.

200Una nueva representación completa
Qué significa
En este fragmento, el servidor responde al GET condicional con cuerpo JSON y validador demo-v2.
Qué comprobar
Compare If-None-Match, ETag y la revisión del cuerpo. El ensayo local analiza el JSON de este ejemplo.
Precaución
Un 200 no garantiza JSON válido ni datos de negocio correctos. Analizar este cuerpo no valida el esquema de sus propios datos.
Fragmento de intercambio ficticio
GET /demo/catalogue
If-None-Match: "demo-v1"

HTTP/1.1 200 OK
ETag: "demo-v2"
Content-Type: application/json

{"revision":"demo-v2"}

304Copia revalidada, sin cuerpo nuevo
Qué significa
304 responde a una petición condicional: puede reutilizarse la representación guardada. No aporta un cuerpo nuevo.
Qué comprobar
Compare el validador enviado con la copia demo-v2 disponible. La interpretación depende también de esa copia.
Precaución
La prueba crea una Response 304 aislada, no una caché HTTP. En un fetch real el navegador puede entregar la respuesta guardada: estado de red y estado visible al script pueden diferir.
Fragmento de intercambio ficticio
GET /demo/catalogue
If-None-Match: "demo-v2"

HTTP/1.1 304 Not Modified
ETag: "demo-v2"

Referencias técnicas : RFC 9110 §15 · MDN · Response.ok · MDN · Response.json() · WHATWG · Fetch · .

Matriz de validación funcional para adaptarse al proyecto

Estos controles propuestos utilizan casos ficticios. Decida qué comportamiento se espera con el equipo, anote el resultado y asigne discrepancias no resueltas antes de la publicación.

Desplace la tabla horizontalmente para leer todas las columnas. Con el teclado, sitúe el foco en la tabla y use las flechas.

Casos de prueba, resultados esperados y evidencia útil
CasoResultado esperadoPrueba para mantener
Página pública sin cambiosLa política anunciada y la respuesta condicional siguen siendo consistentes en todas las solicitudes.Encabezados, validador y estado de ambas solicitudes, con el estado del navegador registrado.
Cambio de contenido públicoLa versión corregida llega dentro de las condiciones de frescura definidas.Contenido antiguo y nuevo, tiempo de solicitud y encabezados recibidos.
Dos cuentas de pruebaNunca se sirve una respuesta personalizada para la primera cuenta a la segunda.Solicitudes aisladas y contenidos recibidos por cada cuenta sintética.
Cerrar sesión y volverEl comportamiento de pantalla sensible coincide con el requisito de confidencialidad documentado.Completa la secuencia del navegador y las limitaciones registradas explícitamente.

Preguntas frecuentes

¿Son equivalentes sin caché y sin tienda?

No. El primero requiere validación antes de la reutilización; El segundo solicita que no se almacene la respuesta. Elija de acuerdo con el contenido y los cachés involucrados, luego pruebe los viajes afectados.

¿Debe cada recurso compartir un caché de por vida?

Una sola vida ignora las diferencias entre los activos públicos versionados, las páginas editoriales, los precios y las respuestas personalizadas. Clasifique las respuestas, defina su proceso de actualización y pruebe los estados de inicio de sesión antes de elegir los tiempos de vida.