Como o cache distingue versões da mesma URL
O Vary é um cabeçalho de resposta HTTP que informa quais campos da requisição influenciaram a escolha do conteúdo enviado. Um servidor pode usar a mesma URL para responder com idiomas ou codificações diferentes. O cache usa a indicação de Vary para conferir se uma versão armazenada corresponde à nova requisição.
A comparação considera os cabeçalhos indicados e admite as normalizações permitidas para cada campo. Segundo a RFC 9111, uma resposta armazenada com Vary só pode ser reutilizada sem revalidação quando esses campos correspondem aos da requisição original. As demais condições de reutilização do cache também precisam ser atendidas.
Uma página comprimida com gzip
Neste exemplo, um cliente envia Accept-Encoding: gzip ao consultar uma página. O servidor escolhe a versão comprimida e inclui na resposta:
Content-Encoding: gzipVary: Accept-EncodingO primeiro cabeçalho descreve a codificação do conteúdo enviado. O segundo orienta o cache a considerar o campo Accept-Encoding ao selecionar essa resposta. Uma nova consulta com Accept-Encoding: identity solicita conteúdo sem compressão, portanto a versão gzip armazenada não pode ser reutilizada diretamente para atendê-la.
Você pode comparar os cabeçalhos das requisições e das respostas para investigar uma variante incorreta. Incluir Vary na resposta não faz o servidor produzir as versões: a aplicação ou o servidor precisa selecionar e gerar o conteúdo adequado.
Seleção da variante e validade
O Vary não estabelece o tempo de armazenamento. Cabeçalhos como Cache-Control definem outras condições de uso, incluindo a validade da resposta. Liste em Vary os campos que realmente influenciam a seleção, pois campos desnecessários podem separar respostas equivalentes e reduzir a reutilização do cache.
Dúvidas frequentes
Perguntas frequentes sobre Vary
- Vary define o prazo de validade do cache?
- O prazo é determinado por outras informações, como a diretiva max-age de Cache-Control. Vary identifica os campos da requisição usados para selecionar uma variante armazenada.
- O que significa Vary com asterisco?
- Vary: * indica que a seleção depende de algo além dos campos nomeados da requisição. Uma resposta armazenada com essa indicação exige revalidação para ser reutilizada.
- É possível indicar vários cabeçalhos?
- Sim. Vary aceita uma lista separada por vírgulas, como Accept-Encoding, Accept-Language. Ela deve corresponder aos campos que influenciaram a seleção da resposta.
Para continuar
Recursos relacionados
Documentação
MDN: variações da resposta com Vary
Explica a sintaxe de Vary e o uso dos cabeçalhos da requisição na seleção de respostas armazenadas.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
A orientação ao vivo pode ajudar você a investigar uma resposta incorreta do cache e revisar os cabeçalhos enviados pela aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Ao revisar uma aplicação web, você precisa conferir se o cache reutiliza a versão da resposta adequada aos cabeçalhos enviados pelo cliente.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.