# 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.

> 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`.

João Rizzon · 2026-10-27 · Infraestrutura web

---

## 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 `F12` para 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](https://docs.litespeedtech.com/lscache/lscps/troubleshoot/)).

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

O mesmo teste, sem navegador:

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

- `-s` deixa o curl em silêncio, sem a barra de progresso.
- `-o /dev/null` descarta 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 litespeed` filtra 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 `miss` ou 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 `miss` com o módulo ativo, `hit` sem 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-cookie` de 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 `miss` legí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 `miss` o 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-cache` na primeira e na segunda recarga.
- Os nomes de `set-cookie` vistos 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](https://docs.litespeedtech.com/lscache/lscps/troubleshoot/), documentação oficial da LiteSpeed Technologies.

