Pesquisar
Introduza pelo menos dois caracteres, sem dados pessoais.

    BibliotecaArtigos e FAQs Seu projetoSolicite um orçamento
    LínguaPT ▾
    Guias práticos

    Configurar o cache HTTP sem expor dados privados

    O cache ajuda apenas quando a resposta reutilizada é apropriada para o visitante e o horário de acesso. Uma única política para cada recurso pode ocultar uma atualização ou expor uma resposta personalizada.

    Veja o método

    Ilustração — Configurar o cache HTTP sem expor dados privados
    Ilustração gerada por IA

    Classifique as respostas antes de escolher uma vida inteira

    Páginas públicas de inventário, ativos estáticos, respostas da API, contas e confirmações. Registre se cada mudança com o usuário, idioma ou parâmetro. Identifique os caches do navegador, do intermediário e do CDN. Uma página de conta não deve herdar a política de uma fotografia pública simplesmente porque essa política é fácil de aplicar.

    Distinguir o frescor da permissão para armazenar uma resposta. O MDN explica que o No-Cache requer revalidação, enquanto No-Store não solicita armazenamento. Private restringe o armazenamento a caches privados. Um cookie sozinho não torna automaticamente uma resposta privada.

    Planeje como uma atualização se torna visível

    Escreva uma regra de atualização para cada família. Para um arquivo com versão, confirme se a nova página solicita o novo URL. Para uma página pública com um endereço estável, descreva a revalidação ou a limpeza. Uma longa vida útil sem um procedimento de substituição apenas move o problema para a próxima mudança de conteúdo.

    Escolha um exemplo prático: uma correção de preços, horário de funcionamento ou um documento substituído. Registre quando a origem muda e inspecione uma sessão que já tenha visitado a página. Um novo navegador por si só não cobre um visitante que retorna, mantendo uma resposta anterior.

    Durante a revalidação, o navegador pode enviar em If-None-Match o ETag da cópia guardada. Se a representação ainda corresponder, uma resposta 304 permite reutilizar o corpo conservado; não transmite um novo corpo da página. Se mudou, uma resposta completa 200 pode fornecer o conteúdo e o novo validador. Um código isolado não descreve, portanto, o que o visitante acaba por ver.

    Se a primeira resposta incluir Last-Modified, copie essa data sem alterações para If-Modified-Since num segundo GET ao mesmo URL. Um 304 indica que a data de modificação no servidor não é mais recente do que a data enviada. Se o servidor disponibilizar duas versões no mesmo segundo, a data pode coincidir mesmo com alterações no conteúdo. Use um ETag que distinga as versões quando esta precisão for importante. Se o pedido incluir ambos os campos condicionais, If-None-Match tem prioridade.

    A tabela usa os validadores fictícios demo-v1 e demo-v2 para distinguir etapas, sem medir este site. Guarde em conjunto pedido condicional, resposta, cópia reutilizada e correção apresentada. Um ETag é um identificador opaco produzido pelo servidor, não necessariamente uma impressão digital ou data. Teste também Voltar: o histórico pode restaurar uma imagem do estado através de um mecanismo distinto da cache HTTP.

    Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.

    Exemplo fictício: acompanhar a revalidação até ao conteúdo apresentado
    Situação de testeTroca a relacionarProva útil
    Primeira leitura200 com corpo e ETag demo-v1.A cópia inicial contém a versão esperada.
    Revalidação sem alteraçõesIf-None-Match demo-v1, depois 304.O corpo guardado é reutilizado; não chega um novo corpo.
    Representação alteradaIf-None-Match demo-v1, depois 200 com demo-v2.O novo corpo é recebido e a correção fica efetivamente visível.
    Resposta 304 observada isoladamenteA resposta tem de ser relacionada com a cópia guardada.Só o código não prova recuperação do conteúdo nem apresentação da variante correta.

    Teste identidades e estados diferentes

    Em um ambiente de teste, compare uma visita anônima, duas contas distintas, logout e navegação de volta. Inspecione o conteúdo exibido e os cabeçalhos recebidos em vez de apenas a configuração de hospedagem. Use registros de teste sintéticos em vez de documentos pessoais reais.

    Inclua linguagem, dispositivo, filtro e estados de erro relevantes. Mantenha o URL, o estado da sessão, a resposta esperada e o resultado de cada teste. Quando a personalização passa por um cache compartilhado, peça ao proprietário da infraestrutura que revise as chaves e exclusões do cache.

    Mantenha um procedimento de recuperação

    Documente quem pode limpar o cache, verificar seu efeito e restaurar uma configuração anterior. Um amplo expurgo pode reduzir temporariamente os benefícios do armazenamento em cache; portanto, prepare uma verificação das páginas essenciais após a operação.

    Revise a política quando as contas do cliente, o comércio, um idioma ou um CDN são introduzidos. Uma entrega útil é uma matriz Response–Policy–Test–Owner. Uma pontuação de desempenho por si só não estabelece frescor nem isolamento entre os usuários.

    Documentação principal: MDN : Cache HTTP.

    Impedir que uma cache partilhada entregue a variante errada.

    Caso fictício: uma URL fornece dois formatos conforme um cabeçalho. Teste ambos atrás da cache real e a chave de variação, incluindo Vary quando adequado. Edições editoriais podem precisar de URL distintas. A variante escolhida explicitamente deve continuar acessível.

    • Cada pedido recebe a variante correta, mesmo depois da outra e com cache ativa.
    • MDN Content Negotiation

      Guia da seleção de representações HTTP por idioma, formato, codificação ou capacidades do cliente.

    Separar respostas pessoais na cache

    Dois portáteis com marcadores coloridos junto a um router
    Ilustração gerada por IA · Observe separadamente o conteúdo de duas sessões de teste.

    Caso proposto: uma confirmação pessoal passa por uma cache partilhada. É preciso observar o que recebe cada sessão.

    Use duas sessões de teste isoladas. Compare pedidos, cabeçalhos e conteúdo; uma regra geral não comprova sozinha a separação observada.

    • Abrir duas sessões isoladas
    • Comparar cabeçalhos e conteúdo
    • Registar a separação

    Documentos de referência

    Conteúdo atualizado

    Referências documentadas para este tema

    Referências documentadas para este tema
    ReferênciaValor ou sintaxeÂmbito
    HTTP · 304
    If-None-Match → 304Num pedido GET ou HEAD, uma representação inalterada pode ser reutilizada sem reenviar o corpo.
    MDN · Vary
    Vary: Accept-LanguageSe o mesmo URL produzir respostas diferentes segundo Accept-Language, Vary indica esse critério à cache. Mantenha o valor coerente nas respostas 200 e 304. URLs distintos por língua não exigem este cabeçalho apenas por o site ser multilingue.
    HTTP · If-Match
    If-Match: "r7" → 412If-Match compara um validador forte antes de escrever. No contrato ilustrado, uma versão antiga recebe 412; conserve o rascunho para comparar alterações.

    As datas indicam a consulta das fontes. Estes dados não constituem uma auditoria do site nem uma declaração global de conformidade.

    Ler uma revalidação da cache

    Compare um corpo substituído e uma cópia reutilizada. Os excertos mostram validadores e conteúdo disponível, além do código.

    Os excertos são incompletos e usam endereços de demonstração. O ensaio cria uma Response em memória: não contacta servidores nem simula rede, cache ou processamento de negócio.

    200Uma nova representação completa
    Significado
    Neste excerto, o servidor responde ao GET condicional com corpo JSON e validador demo-v2.
    O que verificar
    Compare If-None-Match, ETag e a revisão no corpo. O ensaio local analisa o JSON deste exemplo.
    Atenção
    Um 200 não garante JSON válido nem dados de negócio corretos. A análise bem-sucedida não valida o esquema dos seus dados.
    Excerto de troca fictícia
    GET /demo/catalogue
    If-None-Match: "demo-v1"
    
    HTTP/1.1 200 OK
    ETag: "demo-v2"
    Content-Type: application/json
    
    {"revision":"demo-v2"}

    304Cópia revalidada, sem novo corpo
    Significado
    304 responde a um pedido condicional: a representação guardada pode ser reutilizada. Não fornece um novo corpo.
    O que verificar
    Compare o validador enviado com a cópia demo-v2 disponível. A interpretação depende também dessa cópia.
    Atenção
    O ensaio cria uma Response 304 isolada, não uma cache HTTP. Num fetch real o navegador pode fornecer a resposta guardada: estado de rede e estado exposto ao script podem diferir.
    Excerto de troca fictícia
    GET /demo/catalogue
    If-None-Match: "demo-v2"
    
    HTTP/1.1 304 Not Modified
    ETag: "demo-v2"

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

    Matriz de validação funcional para se adaptar ao projeto

    Esses controles propostos usam casos fictícios. Decida qual comportamento é esperado com a equipe, anote o resultado e atribua discrepâncias não resolvidas antes da publicação.

    Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.

    Casos de teste, resultados esperados e evidências úteis
    CasoResultado esperadoProva para guardar
    Página pública inalteradaA política anunciada e a resposta condicional permanecem consistentes em todas as solicitações.Cabeçalhos, validador e status de ambas as solicitações, com o estado do navegador registrado.
    Conteúdo público alteradoA versão corrigida chega dentro das condições definidas de frescura.Conteúdo antigo e novo, pedido de tempo e cabeçalhos recebidos.
    Duas contas de testeUma resposta personalizada para a primeira conta nunca é servida para a segunda.Solicitações isoladas e conteúdo recebido por cada conta sintética.
    Saia e volteO comportamento da tela sensível corresponde ao requisito de confidencialidade documentado.Sequência completa do navegador e limitações explicitamente registradas.

    Perguntas frequentes

    São equivalentes sem cache e sem loja?

    Não. A primeira requer validação antes da reutilização; O segundo solicita que a resposta não seja armazenada. Escolha de acordo com o conteúdo e caches envolvidos e teste as jornadas afetadas.

    Todos os recursos devem compartilhar um tempo de vida de cache?

    Uma única vida ignora as diferenças entre ativos públicos com versão, páginas editoriais, preços e respostas personalizadas. Classifique as respostas, defina seu processo de atualização e teste os estados conectados antes de escolher o tempo de vida.