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.

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
- Leia o cabeçalho x-litespeed-cache antes de mexer em qualquer coisa
- Miss em toda recarga quase sempre é cookie de sessão, não servidor
- Bissecção de módulos: desative um por vez e meça o cabeçalho
- Carrinho, checkout e conta do cliente nunca podem ser cacheados
- Oito verificações para fechar o diagnóstico
- Quando a página já vem em hit e a loja continua lenta
- 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:
- Aperte
F12para abrir as ferramentas de desenvolvedor. - Clique na aba Rede (Network).
- Marque Desativar cache (Disable cache), para o navegador não enganar você com a cópia local.
- Recarregue a página com
Ctrl+F5. - Na lista de requisições, clique na primeira linha, a do próprio documento HTML (o nome costuma ser a URL da categoria).
- 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
-sdeixa o curl em silêncio, sem a barra de progresso.-o /dev/nulldescarta o HTML baixado, você não quer ver a página inteira no terminal.-D -imprime os cabeçalhos de resposta na tela.grep -i litespeedfiltra as linhas que citam LiteSpeed, ignorando maiúsculas.
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.
Miss em toda recarga quase sempre é cookie de sessão, não servidor
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:
- Módulo de seletor de moeda ou de idioma que grava a escolha assim que a página carrega.
- Módulo de live chat que abre a sessão para numerar o atendimento.
- Módulo de estatística, rastreamento ou pixel que marca o visitante antes de qualquer clique.
- Módulo de produtos vistos recentemente ou de comparação, que grava a lista na sessão.
- Módulo de banner de cookies mal feito, que grava a preferência do lado do servidor em vez do navegador.
Nenhum desses é vilão por natureza. O problema é o momento: gravar sessão no primeiro byte de um visitante anônimo.
Onde ver o set-cookie nascendo na primeira visita anônima
Na mesma aba Rede, com a janela anônima:
- Clique na requisição do documento HTML.
- Vá em Response Headers e procure
set-cookie. - 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.
- Segunda recarga volta
hit: o cache está ativo em manutenção, pode seguir para o passo 2. - Segunda recarga volta
missou o cabeçalho some: não dá para caçar módulo assim. Religue a loja e faça a bissecção com ela ativa, em horário de baixo movimento, testando sempre do mesmo IP e limpando o cache entre as rodadas.
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.
- Continua
miss: reative o módulo e passe para o próximo da lista. - Virou
hit: você achou. Mantenha desativado e vá para o passo 4.
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:
- 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").
- Trocar por um equivalente que faça o mesmo pelo lado do navegador, não pela sessão do servidor.
- Abrir chamado com o desenvolvedor do módulo descrevendo o que você mediu: cabeçalho
misscom o módulo ativo,hitsem ele. - 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.
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:
- Home na segunda recarga:
x-litespeed-cache: hit. - Três categorias diferentes na segunda recarga:
hit. - Três produtos diferentes na segunda recarga:
hit. - Primeira visita de anônimo na home: sem
set-cookiede sessão. - Carrinho com item: não servido como conteúdo de outro visitante.
- Checkout: nunca cacheado.
- Login de cliente: sessão funciona, nome aparece no topo.
- Após salvar um produto no back office, a página pública reflete a mudança (purge funcionando).
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.
- Imagem pesada. Categoria com 48 miniaturas em tamanho original pesa mais que qualquer ganho de cache. Verifique o tamanho transferido na coluna Size da aba Rede.
- Primeiro acesso de cada URL. O primeiro visitante sempre paga a geração. Loja com catálogo enorme e pouco tráfego tem muito
misslegítimo. - Back office lento. O back office não é cacheado. Lentidão lá aponta para banco, índice ou consulta pesada, não para o LSCache.
- Purge agressivo demais. Se cada alteração de estoque limpa a loja inteira, você volta ao
misso tempo todo. Revise as regras de purge. - Terceiros no HTML. Script externo de chat, pixel e mapa bloqueia a renderização mesmo com o HTML vindo do cache. Isso aparece como requisição de outro domínio na aba Rede.
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:
- A URL exata testada (uma categoria, não "o site").
- O valor de
x-litespeed-cachena primeira e na segunda recarga. - Os nomes de
set-cookievistos na primeira visita anônima. - A lista de módulos que você desativou e o que mudou em cada rodada.
- Versão do PrestaShop e versão do módulo LiteSpeed Cache.
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
- Documentação oficial (litespeed) — LSCache for PrestaShop: Troubleshooting. Consultado em 2026-10-14.