Um arquivo JavaScript com hash no nome pode ficar em cache por muito tempo porque o próximo build publica outro nome. O HTML que referencia esse arquivo precisa de uma política diferente. Se o navegador continuar recebendo HTML antigo, pode pedir arquivos que já saíram do servidor.
Revalidação de uma representação
Uma resposta com Cache-Control: no-cache pode ser armazenada, mas precisa ser revalidada antes de ser reutilizada. Com um ETag, o cliente pode enviar If-None-Match. Se a representação ainda for a mesma, o servidor pode responder 304 e o cliente reaproveita o corpo armazenado. Cache-Control: no-store orienta caches a não armazenarem a resposta.
Para dados de um painel autenticado, revise o que um cache compartilhado pode guardar. private restringe o armazenamento a caches privados. Use uma política compatível com a sensibilidade do conteúdo e confira os cabeçalhos efetivamente entregues pelo CDN.
No teste, altere o conteúdo de uma URL que mantém o mesmo caminho. Faça uma chamada condicional com o ETag anterior e confira se recebe o corpo novo. Repita sem alterar o conteúdo para verificar o 304.
Documentação de referência · Como depurar uma API com curl e ver status e cabeçalhos
Separe cache de navegador e cache compartilhado
private permite armazenamento por caches privados e impede o compartilhamento por caches compartilhados conforme a semântica do HTTP. public pode tornar uma resposta elegível para armazenamento compartilhado, desde que as demais diretivas permitam. Não marque conteúdo personalizado como público sem avaliar cookies, autorização e dados que podem vazar entre usuários. A configuração do CDN e os cabeçalhos de origem precisam estar em acordo.
Vary informa quais cabeçalhos da requisição alteram a representação. Use-o apenas para dimensões relevantes; uma grande variedade de valores fragmenta o cache. Se a resposta muda por idioma, por exemplo, prefira uma URL distinta ou uma estratégia de variação que o CDN compreenda. Teste um usuário autenticado e outro anônimo para verificar que a resposta correta não se cruza.
Use ETag para revalidar, não para esconder uma política
ETag identifica uma versão da representação e pode economizar o envio do corpo em uma resposta 304. Ele não determina por quanto tempo a resposta pode ser mantida fresca. Cache-Control e validadores trabalham juntos: a política controla frescor e a requisição condicional pergunta se a cópia continua válida. Para recursos estáticos com hash no caminho, uma expiração longa pode ser adequada; para HTML que referencia os assets, a política costuma ser mais curta.
Verifique cabeçalhos numa nova versão, numa requisição condicional e após uma atualização de conteúdo. Inspecione a resposta do CDN, não apenas a configuração do framework, pois camadas intermediárias podem sobrescrever diretivas.
Uma resposta 304 não contém o corpo da representação, então o cliente precisa ter uma cópia armazenada que possa reutilizar. Se a resposta original não foi armazenada, a revalidação pode não economizar transferência. Verifique a sequência completa no navegador ou com duas chamadas HTTP, incluindo o validador e a política de cache. Também confirme que o servidor não reutiliza um ETag de uma versão antiga depois de alterar o conteúdo servido na mesma URL.