blog
Infraestrutura web

LiteSpeed Cache ativo e PrestaShop lento: caçando o miss

O cabeçalho x-litespeed-cache diz em três segundos se a categoria vem do cache. Se vier como miss em toda recarga, o culpado costuma ser um módulo criando sessão antes da hora.

JR · · 9 min de leitura · 2 tabelas · 1 bloco de código

Resposta curta: Se o cabeçalho `x-litespeed-cache` volta `miss` em toda recarga, a causa mais comum é um módulo criando cookie de sessão já na primeira visita de um visitante anônimo. Confirme o `set-cookie` na aba Rede do navegador e desative um módulo por vez até o cabeçalho virar `hit`.

Neste artigo
  1. Leia o cabeçalho x-litespeed-cache antes de mexer em qualquer coisa
  2. Miss em toda recarga quase sempre é cookie de sessão, não servidor
  3. Bissecção de módulos: desative um por vez e meça o cabeçalho
  4. Carrinho, checkout e conta do cliente nunca podem ser cacheados
  5. Oito verificações para fechar o diagnóstico
  6. Quando a página já vem em hit e a loja continua lenta
  7. Os cinco dados que fazem o chamado ser respondido de primeira

Leia o cabeçalho x-litespeed-cache antes de mexer em qualquer coisa

Antes de mexer em módulo, em configuração ou em plano de hospedagem, descubra se a categoria lenta está sendo servida do cache ou gerada pelo PHP a cada visita. O LiteSpeed responde isso num cabeçalho HTTP.

No Chrome ou no Firefox, abra a página de categoria em uma janela anônima (sem login de cliente, sem carrinho) e faça assim:

  1. Aperte F12 para abrir as ferramentas de desenvolvedor.
  2. Clique na aba Rede (Network).
  3. Marque Desativar cache (Disable cache), para o navegador não enganar você com a cópia local.
  4. Recarregue a página com Ctrl+F5.
  5. Na lista de requisições, clique na primeira linha, a do próprio documento HTML (o nome costuma ser a URL da categoria).
  6. Vá em Headers e role até Response Headers.

Procure a linha x-litespeed-cache. Recarregue duas ou três vezes seguidas e anote o que aparece em cada recarga.

O que aparece Leitura O que fazer
x-litespeed-cache: hit A página saiu do cache Nada. Essa URL está ok
x-litespeed-cache: miss na 1ª e hit nas seguintes Comportamento normal Nada. O primeiro visitante paga a geração
x-litespeed-cache: miss em toda recarga A página nunca entra no cache Siga para as próximas seções
O cabeçalho não existe O LiteSpeed não está cacheando essa resposta Confirme servidor LiteSpeed e módulo ativo

O caso que interessa aqui é o terceiro: miss sempre. A documentação de troubleshooting do LSCache para PrestaShop trata justamente esse cenário, de loja com cache ativo e página que não é servida do cache (docs.litespeedtech.com).

O mesmo teste pelo terminal, com curl e GET (nunca HEAD)

O mesmo teste, sem navegador:

curl -s -o /dev/null -D - https://exemplo.com.br/9-camisetas | grep -i litespeed

Não troque isso por curl -sI. O -I faz uma requisição HEAD, e HEAD pode não popular nem ler a mesma entrada de cache do GET: você veria miss em toda chamada mesmo com a página cacheada. O teste precisa ser GET, que é o que o visitante real faz.

A URL acima é um exemplo fictício; troque pela URL real de uma categoria sua. Resultado esperado quando está bom: uma linha com x-litespeed-cache: hit a partir da segunda chamada.

Caminho do diagnóstico de miss no LSCacheLeia x-litespeed-cacheJanela anônima, aba Rede, duas recargasSempre miss?Se vier hit na segunda, pare aquiProcure set-cookieSessão nascendo na primeira visitaIsole o móduloDesative um por vez e releiaConfirme rotas privadasCarrinho e checkout fora do cache
Ordem do diagnóstico: medir primeiro, mexer depois.

Um cache de página pública guarda uma resposta e a entrega igual para todo mundo. Para fazer isso com segurança, o LiteSpeed precisa ter certeza de que a resposta não contém nada particular daquele visitante. O sinal que ele usa para decidir é o cookie.

Quando a loja cria um cookie de sessão logo na primeira visita de um anônimo, o pedido deixa de ser genérico. A documentação do LSCache para PrestaShop lista exatamente isso entre as causas de página não cacheada: há conteúdo ou cookie que torna a resposta específica da sessão. Resumo brutal: o cache está funcionando, a loja é que avisa, em toda visita, "este cliente é único".

Quem costuma criar essa sessão cedo demais:

Nenhum desses é vilão por natureza. O problema é o momento: gravar sessão no primeiro byte de um visitante anônimo.

Na mesma aba Rede, com a janela anônima:

  1. Clique na requisição do documento HTML.
  2. Vá em Response Headers e procure set-cookie.
  3. Anote os nomes que aparecem. Em PrestaShop você costuma ver o cookie do front office e, às vezes, o da sessão do PHP.

Se a primeira visita de um anônimo já traz set-cookie, você encontrou o motivo do miss.

Bissecção de módulos: desative um por vez e meça o cabeçalho

Este é o procedimento que resolve. Ele é chato porque é sequencial, e é sequencial porque desativar cinco módulos de uma vez não diz qual era o problema.

Risco e como voltar atrás: desativar módulo mexe em loja viva. Faça backup completo de arquivos e banco antes de começar, pelo painel da hospedagem ou pelo seu procedimento habitual. Anote em papel ou num bloco de notas a lista dos módulos que você desativar, na ordem. Reativar é um clique, mas só se você souber o que desligou.

Ligue a manutenção e confirme que o cache ainda responde hit

No back office, vá em Parâmetros da Loja > Manutenção. Desligue Ativar Loja e coloque o seu IP em IPs de manutenção. Assim o cliente vê a página de manutenção e você continua navegando normalmente. Descubra seu IP em qualquer site de "qual é o meu IP".

Antes de desativar qualquer módulo, confirme que o cache continua funcionando em manutenção. Com a loja desativada, é comum o LSCache parar de servir resposta cacheada, inclusive para o IP liberado. Se isso acontecer, todo módulo vai parecer culpado, porque o cabeçalho virá miss sempre. O teste de sanidade leva um minuto: com a manutenção já ligada, abra a categoria em janela anônima a partir do seu IP e recarregue duas vezes.

Limpe o cache do LSCache antes de cada rodada de teste

Teste com cache sujo não vale. A cada rodada, limpe o cache do LSCache pelo back office, em Módulos > LiteSpeed Cache > Configurar, usando a opção de limpar tudo. Depois recarregue a categoria em janela anônima nova.

Desative o primeiro suspeito e releia o cabeçalho na segunda recarga

Em Módulos > Gerenciador de Módulos, localize o primeiro suspeito da lista da seção anterior. Clique em Desativar (não desinstale: desinstalar apaga configuração, desativar não).

Agora repita o teste do cabeçalho: janela anônima, F12, aba Rede, Ctrl+F5 duas vezes. Olhe x-litespeed-cache na segunda recarga.

O que fazer depois de identificar o módulo que cria a sessão

Achar não é o fim. Opções, da melhor para a pior:

  1. Procurar nas opções do módulo um ajuste que adie a sessão (muito módulo de chat tem "carregar sob demanda" ou "carregar ao clicar").
  2. Trocar por um equivalente que faça o mesmo pelo lado do navegador, não pela sessão do servidor.
  3. Abrir chamado com o desenvolvedor do módulo descrevendo o que você mediu: cabeçalho miss com o módulo ativo, hit sem ele.
  4. Viver sem o módulo, se ele não for essencial.

Religue a loja e confirme a home em janela anônima

Volte em Parâmetros da Loja > Manutenção e religue Ativar Loja. Confirme numa janela anônima que a home abre normal.

Uma rodada de bissecção de módulosBackup e manutençãoArquivos, banco e seu IP liberadoTeste de sanidadeCache ainda responde hit em manutençãoLimpar cacheUma limpeza antes de cada rodadaDesativar um suspeitoDesativar, nunca desinstalarReler o cabeçalhoSegunda recarga decide a rodada
Cada rodada da bissecção segue estas cinco fases, sempre na mesma ordem.

Carrinho, checkout e conta do cliente nunca podem ser cacheados

Categoria em hit só é bom se carrinho, checkout e conta do cliente continuarem fora do cache. Nessas rotas, servir uma cópia de outro visitante é falha grave, não lentidão.

Área Deve ser cacheada Por quê
Home, categoria, página de produto Sim Conteúdo igual para todo anônimo
Carrinho Não Conteúdo pessoal
Checkout e pagamento Não Dados do pedido e sessão ativa
Minha conta, pedidos, endereços Não Área autenticada
Busca interna Depende Muitas variações, pouco reuso

No módulo LiteSpeed Cache do PrestaShop, revise a lista de URLs e de cookies excluídos antes de considerar a tarefa encerrada. Teste na prática: adicione um produto ao carrinho, abra o checkout e confirme que o cabeçalho de resposta dessas páginas não vem como hit de um conteúdo que não é seu.

Oito verificações para fechar o diagnóstico

Rode esta lista com a loja fora de manutenção, em janela anônima nova:

Se algum item falhar, volte ao passo do cabeçalho naquela URL específica. O diagnóstico é sempre o mesmo: ler x-litespeed-cache, olhar set-cookie, isolar quem cria sessão.

Quando a página já vem em hit e a loja continua lenta

Vale dizer contra o interesse de quem vende hospedagem: se a categoria já está em hit e continua lenta, o cache de página não vai salvar. Investigue outras frentes antes de trocar de plano.

Os cinco dados que fazem o chamado ser respondido de primeira

Se for abrir chamado, com o desenvolvedor do módulo ou com o suporte da hospedagem, mande o diagnóstico pronto. Um chamado útil tem:

Esses cinco itens transformam "minha loja está lenta" em um problema com causa provável. É a diferença entre uma resposta genérica e alguém olhando a linha certa.

Fonte consultada: LSCache for PrestaShop: Troubleshooting, documentação oficial da LiteSpeed Technologies.

Referências

  1. Documentação oficial (litespeed) — LSCache for PrestaShop: Troubleshooting. Consultado em 2026-10-14.
Leia também