[HTTP](/blog/tag/http)[Web](/blog/tag/web)

# Como usar Cache-Control e ETag em respostas HTTP

[![Bendev Junior](/images/bendev.jpg)Bendev Junior](/sobre)Publicado em 17 de novembro de 2026 às 09:00 GMT-41 min de leitura[Ver Web Story 9:16](/stories/http-cache-control-etag)

![Como usar Cache-Control e ETag em respostas HTTP](/images/blog-covers/http-cache-control-etag.svg)

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](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Caching) · [Como depurar uma API com curl e ver status e cabeçalhos](/blog/curl-depurar-http-status-headers)

## 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.

## Leia também

Mais artigos sobre o tema.

-   [Como depurar uma API com curl e ver status e cabeçalhosLer artigo](/blog/curl-depurar-http-status-headers)
-   [Promise.all ou Promise.allSettled em um dashboard?Ler artigo](/blog/javascript-promise-allsettled-dashboard)
-   [Como manter filtros de uma página na URL com URLSearchParamsLer artigo](/blog/javascript-urlsearchparams-filtros)

[Abrir Web Story](/stories/http-cache-control-etag)[Ver todos os artigos](/blog)[Projetos](/projetos)[Livros](/livros)[Sobre Bendev](/sobre)

![Bendev Junior](/images/bendev.jpg)

Bendev Junior

Tech Lead e Arquiteto de Software.

[Voltar ao blog](/blog)
