Dicas e Soluções

Varnish no Magento 2: por que a loja exibe páginas antigas mesmo após limpar o cache?

Especialista analisando Varnish e cache do Magento 2 em um data center

Varnish no Magento 2: por que a loja exibe páginas antigas mesmo após limpar o cache?

Varnish no Magento 2 pode reduzir o trabalho da aplicação e acelerar a entrega da vitrine, mas uma configuração incompleta também pode manter páginas antigas visíveis depois de mudanças em preços, produtos, categorias ou blocos. Quando isso acontece, limpar todos os caches repetidamente raramente identifica a causa.

Antes de reiniciar serviços ou substituir o arquivo VCL, registre a URL afetada, o horário da alteração, o resultado esperado e quais visitantes enxergam o conteúdo antigo. O roteiro abaixo ajuda a descobrir se a resposta desatualizada vem do Magento, do Varnish, de outro proxy ou do navegador.

Varnish no Magento 2: confirme o alcance do problema

Comece comparando páginas e tipos de acesso. Uma inconsistência restrita a uma categoria exige uma investigação diferente de toda a vitrine desatualizada. Faça testes controlados em uma janela anônima e, se possível, diretamente na origem por uma rota interna autorizada.

  • Verifique a página inicial, uma categoria, um produto e uma página institucional.
  • Compare visitantes anônimos e clientes autenticados.
  • Teste a URL com e sem parâmetros que façam parte da navegação normal.
  • Confirme se o problema aparece em mais de um navegador ou rede.
  • Anote se preço, estoque, imagem, layout ou a página inteira estão antigos.

Se apenas preço, estoque ou associação de categoria estiver incorreto, o problema pode estar nos índices ou nos dados, não no cache HTTP. Nesse caso, consulte o roteiro de diagnóstico de reindexação do Magento 2 antes de concentrar toda a investigação no Varnish.

1. Confirme qual cache de página está configurado

No diretório da aplicação, consulte a configuração efetiva usando o mesmo usuário operacional do Magento:

php bin/magento config:show system/full_page_cache/caching_application
php bin/magento cache:status

O primeiro comando ajuda a confirmar se a instalação está configurada para usar o cache interno ou o Varnish. Compare o resultado com a arquitetura documentada do ambiente. Não altere a configuração diretamente em produção apenas porque ela parece diferente do esperado: a infraestrutura pode possuir automações, múltiplos nós ou variáveis aplicadas durante o deploy.

2. Descubra qual camada entregou a resposta

Inspecione os cabeçalhos HTTP da URL afetada:

curl -I https://www.exemplo.com.br/produto.html

Dependendo da infraestrutura, cabeçalhos como Age, Via, X-Cache ou equivalentes podem indicar passagem por um proxy e possível reaproveitamento da resposta. Esses nomes não são universais e podem ser removidos na borda. Por isso, a ausência deles não prova que o Varnish esteja fora do fluxo.

Repita a requisição algumas vezes e compare status, idade, cookies, redirecionamentos e demais cabeçalhos. Se houver CDN, balanceador ou outro proxy antes do Varnish, cada camada deve ser analisada separadamente.

3. Compare a resposta pública com a origem

Quando a política de infraestrutura permitir, compare a URL pública com a resposta do servidor de origem usando um acesso interno seguro. Preserve o cabeçalho Host esperado pela loja para evitar testar outro virtual host por engano.

Se a origem já entregar conteúdo antigo, o Varnish provavelmente não é a causa inicial. Verifique índices, cache de aplicação, escopo de loja, dados importados e processamento assíncrono. Se a origem estiver correta e a URL pública permanecer antiga, investigue purge, VCL, CDN e distribuição entre nós.

4. Limpe somente o tipo de cache necessário

Para um teste controlado, faça primeiro a limpeza do cache de página completa:

php bin/magento cache:clean full_page

Execute o comando no contexto correto e registre horário e resultado. Evite começar com cache:flush, apagar diretórios manualmente ou esvaziar todos os armazenamentos. Uma limpeza ampla pode afetar outras aplicações, aumentar a carga da loja e eliminar a diferença necessária para localizar o defeito.

Após o comando, teste novamente a mesma URL e inspecione os cabeçalhos. Se nada mudar, confirme se a solicitação de invalidação chegou ao Varnish e a todos os nós responsáveis.

5. Valide o destino usado para purge

O Magento precisa alcançar o destino correto para invalidar objetos no Varnish. Consulte as configurações relacionadas ao cache de página completa:

php bin/magento config:show system/full_page_cache/varnish/access_list
php bin/magento config:show system/full_page_cache/varnish/backend_host
php bin/magento config:show system/full_page_cache/varnish/backend_port

Compare host, porta e lista de acesso com a topologia real. Um hostname antigo, uma porta incorreta, restrições de rede ou um endereço que aponta para somente um dos nós pode fazer o comando terminar sem que todo o conteúdo seja invalidado.

6. Verifique se todos os nós receberam a invalidação

Ambientes com mais de uma instância de Varnish podem produzir um sintoma intermitente: a página aparece correta em uma requisição e antiga na seguinte. Isso acontece quando os nós não compartilham o mesmo estado de cache e apenas parte deles recebe o purge.

Revise balanceamento, resolução de nomes, regras de rede e automação de invalidação. Se houver identificação de nó nos logs internos, correlacione cada resposta com a instância responsável. Não retire servidores do balanceador sem um plano operacional e uma verificação de capacidade.

7. Revise a VCL efetivamente carregada

Não basta confirmar que existe um arquivo VCL no repositório. É necessário verificar qual configuração foi carregada pelo serviço e se ela corresponde à versão e à arquitetura da aplicação.

Compare a VCL ativa com aquela gerada para o ambiente, observando especialmente:

  • tratamento dos métodos de invalidação;
  • lista de remetentes autorizados a executar purge;
  • encaminhamento para o backend correto;
  • regras de cookies e sessões;
  • variações por host, protocolo e loja;
  • customizações adicionadas por infraestrutura ou módulos.

Antes de substituir a VCL, salve a configuração ativa, valide a sintaxe e prepare retorno. Uma regra copiada de outro ambiente pode ignorar diferenças importantes de domínio, porta, SSL e balanceamento.

8. Procure respostas mantidas por grace ou falhas no backend

O Varnish pode ser configurado para servir conteúdo armazenado quando a origem está lenta ou indisponível. Esse comportamento protege a navegação em determinadas falhas, mas pode fazer uma página antiga permanecer visível por mais tempo.

Correlacione o horário da inconsistência com erros do servidor web, PHP-FPM, banco de dados e conexões com serviços internos. Se houver respostas 500 na origem, use também o roteiro de diagnóstico de erro 500 no Magento 2. Reduzir o período de grace sem corrigir a indisponibilidade pode apenas trocar conteúdo antigo por páginas de erro.

9. Diferencie Varnish, cache da aplicação e Redis

Varnish, cache de página completa, cache de configuração, sessões e Redis não representam a mesma camada. Limpar um armazenamento pode não alterar o conteúdo retido em outro. Também é possível que o purge esteja funcionando, mas o Magento gere novamente uma página com dados antigos.

Se houver lentidão, falhas de sessão ou comportamento irregular após a limpeza, verifique a configuração antes de esvaziar bancos Redis. O artigo sobre falhas de Redis no Magento 2 ajuda a separar cache, sessão e conectividade.

10. Teste a correção com evidências

Depois de corrigir a causa, altere um conteúdo controlado em homologação ou use uma mudança comercial previamente autorizada. Registre o horário, execute o fluxo normal de publicação e confirme:

  • quando a origem passou a entregar o conteúdo novo;
  • quando a URL pública foi atualizada;
  • se todos os nós respondem da mesma forma;
  • se páginas não relacionadas continuam em cache;
  • se clientes autenticados, carrinho e checkout permanecem funcionais.

Esse teste evita considerar resolvido um problema que apenas desapareceu temporariamente após uma limpeza geral.

Perguntas frequentes

Limpar o cache do Magento também limpa o Varnish?

A limpeza do cache de página completa deve acionar a invalidação conforme a configuração do ambiente. Se o destino, a lista de acesso, a rede ou a VCL estiverem incorretos, o comando pode não invalidar todos os objetos ou nós.

Por que a página fica correta e depois volta a aparecer antiga?

Esse comportamento pode indicar múltiplos nós com caches diferentes, outra camada intermediária, respostas mantidas durante falhas da origem ou variações de cache por host, cookie e protocolo.

Devo reiniciar o Varnish para atualizar uma página?

Não como primeira medida. Reiniciar o serviço pode causar perda ampla de cache e aumento de carga sem corrigir a origem. Primeiro valide purge, VCL, rede, nós e resposta do backend.

Como saber se o erro está no Varnish ou na reindexação?

Compare a resposta da origem com a URL pública. Se a origem já exibir dados antigos, investigue índices, dados e cache da aplicação. Se a origem estiver correta e a página pública antiga, concentre-se nas camadas de proxy e invalidação.

Conclusão

Quando o Varnish no Magento 2 mantém páginas desatualizadas, a correção começa pela identificação da camada que entregou a resposta. Comparar origem e URL pública, verificar purge, revisar a VCL e testar todos os nós produz um diagnóstico mais confiável do que reiniciar serviços ou esvaziar caches indiscriminadamente.

Se sua operação precisa revisar cache, infraestrutura e publicação sem comprometer a loja, fale com uma equipe especializada em suporte Magento para planejar o diagnóstico e a correção.