# Exclusão do LiteSpeed Cache que não funciona e como auditar

Como pegar cada URL, cookie e User Agent da sua lista de exclusões, testar a resposta pelo cabeçalho e encontrar a linha que nunca funcionou.

> Uma exclusão pode existir e nunca casar com o endereço real: endereço traduzido, barra final com $, nome de cookie diferente. Prove regra por regra: limpe o cache, carregue a URL excluída duas vezes e, se a segunda carga mostrar x-litespeed-cache: hit, aquela regra falhou.

João Rizzon · 2026-11-14 · Infraestrutura web

---

## O que a exclusão faz e qual cabeçalho prova que ela casou

Uma regra de exclusão no LiteSpeed Cache diz ao servidor: esta resposta não deve ir para o cache. Se a regra casar, a página é gerada pelo WordPress a cada visita. Se não casar, a primeira visita gera a página e as seguintes recebem a cópia guardada, com o carrinho, o nome do usuário ou o preço de outra pessoa.

Na tela de configuração não há como saber se a regra casou. A prova está no cabeçalho HTTP que o servidor devolve. A [documentação da LiteSpeed sobre verificar exclusões](https://docs.litespeedtech.com/shared/lscache/settings-verify-exclude/) parte desse princípio: você confirma a exclusão olhando a resposta, não a lista que escreveu.

O cabeçalho que importa é o `x-litespeed-cache`. Os estados que você vai encontrar:

| O que aparece na resposta | O que significa | Para uma URL que deveria estar excluída |
|---|---|---||
| `x-litespeed-cache: hit` | A página veio do cache | Se o cache foi limpo antes do teste, a regra não casou |
| `x-litespeed-cache: miss` | Não estava no cache, mas pode ser guardada agora | Recarregue. Se virar `hit`, a regra não casou |
| Sem `x-litespeed-cache` | O LiteSpeed não tratou a página como cacheável | Esperado para uma página excluída |
| `x-litespeed-cache-control: no-cache` | O plugin marcou a resposta como não cacheável | Esperado para uma página excluída |

O ponto que mais engana: um único `miss` não prova nada. A página excluída e a página que acabou de ter o cache limpo mostram o mesmo `miss` na primeira visita. Sempre recarregue pelo menos uma vez antes de concluir.

## Antes de mexer: exporte a configuração atual

A auditoria vai fazer você editar a lista de exclusões. Uma regra larga demais (um `/` solto, por exemplo) pode tirar o site inteiro do cache e deixar tudo lento. Guarde o estado atual antes.

- No painel do WordPress, entre em **LiteSpeed Cache > Ferramentas** (em inglês, **Toolbox**).
- Abra a aba **Importar / Exportar**.
- Clique em **Exportar** e salve o arquivo no seu computador.

Se algo der errado, volte nessa mesma aba, use **Importar** com o arquivo salvo e limpe o cache. Isso desfaz qualquer alteração de configuração do plugin. Se você também tem backup completo do site pela hospedagem, melhor ainda, mas para esta tarefa o arquivo exportado basta.

## Monte a lista do que deveria ficar fora

Antes de testar, escreva num papel ou planilha tudo o que a sua configuração promete excluir. Abra **LiteSpeed Cache > Cache** e clique na aba **Excluir**. Ali ficam os campos que interessam para esta auditoria:

- **Não armazenar URIs em cache**: trechos de endereço, um por linha.
- **Não armazenar cookies em cache**: nomes de cookie, um por linha.
- **Não armazenar User Agents em cache**: trechos do identificador do navegador ou robô.

Copie cada linha para a sua planilha e, ao lado, anote o endereço real que ela deveria pegar. Exemplo fictício para uma loja WooCommerce em português:

| Regra escrita | Tipo | Endereço ou situação real a testar |
|---|---|---||
| `/cart` | URI | `https://exemplo.com.br/carrinho/` |
| `/finalizar-compra$` | URI | `https://exemplo.com.br/finalizar-compra/` |
| `woocommerce_items_in_cart` | Cookie | visita com o carrinho cheio |
| `MeuApp` | User Agent | acesso pelo aplicativo |

Só de montar essa tabela você já acha parte dos erros. No exemplo, a regra `/cart` nunca vai casar com `/carrinho/`, porque a loja traduziu o endereço. E `/finalizar-compra$` exige que o endereço termine exatamente em `compra`, mas o WordPress serve a página com barra final. Os dois casos aparecem na próxima seção, onde você prova isso pelo cabeçalho.

## Teste cada regra pelo cabeçalho

Você pode testar pelo navegador (só clique) ou pelo terminal (copiar e colar). Os dois mostram o mesmo cabeçalho.

Antes do primeiro teste, limpe o cache: vá em **LiteSpeed Cache > Ferramentas > Limpar** e use **Limpar tudo**. Sem esse passo, uma cópia guardada antes da regra existir pode aparecer como `hit` mesmo com a regra correta, e você conclui errado. Repita a limpeza depois de cada alteração na lista.

### Como ver o cabeçalho pelo navegador

- Abra uma **janela anônima**. Assim você não leva cookies de login, que mudam o comportamento do cache.
- Aperte **F12** para abrir as ferramentas de desenvolvedor e clique na aba **Rede** (**Network**).
- Marque a caixa **Desativar cache** (**Disable cache**), para o navegador não responder sozinho.
- Digite o endereço que deveria estar excluído e carregue a página.
- Na lista, clique na primeira linha (o próprio documento) e procure a seção **Cabeçalhos de resposta**.
- Procure `x-litespeed-cache`. Anote o valor. Recarregue a página e anote de novo.

Se o cache foi limpo antes do teste e na segunda carga aparecer `hit`, a regra daquela URL não está funcionando.

### Como ver o cabeçalho pelo terminal

Se você tem acesso a um terminal (no seu computador já serve, não precisa ser o servidor):

```
curl -sI https://exemplo.com.br/carrinho/
curl -sI https://exemplo.com.br/carrinho/
```

Linha a linha: `curl` faz a requisição, `-s` esconde a barra de progresso e `-I` mostra só os cabeçalhos. Rodamos duas vezes de propósito, pelo mesmo motivo do `miss` explicado acima. Troque `exemplo.com.br` pelo seu domínio. Na saída, procure a linha `x-litespeed-cache`. Na segunda execução, com o cache limpo antes, se aparecer `hit`, a regra falhou.

Para testar uma regra de cookie, envie o cookie junto:

```
curl -sI -H "Cookie: woocommerce_items_in_cart=1" https://exemplo.com.br/
```

O `-H` acrescenta um cabeçalho à requisição. Use exatamente o nome de cookie que está na sua lista. Rode o comando duas vezes, depois de limpar o cache. Se a segunda resposta voltar com `hit` mesmo com o cookie, a regra não casou.

Para testar uma regra de User Agent:

```
curl -sI -A "MeuApp/1.0" https://exemplo.com.br/
```

O `-A` define o identificador enviado. Coloque um valor que contenha o trecho escrito na sua regra.

## Os motivos mais comuns de uma regra nunca casar

Quando o teste mostra `hit` onde não deveria, a causa costuma estar em uma destas categorias. Vá da mais simples para a mais rara.

### Por que a regra não casa com o endereço traduzido

A regra precisa conter um trecho que exista de fato no endereço. Se o tutorial dizia `/cart` e sua loja usa `/carrinho`, a regra fica lá, parada. Copie o endereço direto da barra do navegador, não do tutorial.

### Por que o $ no fim pode impedir a regra de casar

Como orientação prática: trate cada linha do campo de URIs como um trecho que precisa estar contido no endereço. Um `^` no começo serve para exigir que o endereço comece com aquilo, e um `$` no fim, que termine exatamente ali. Não confie nessa leitura sozinha: confirme cada regra pelo teste de cabeçalho da seção anterior. Um erro possível é escrever `/finalizar-compra$` quando a página real é `/finalizar-compra/`. Ou tire o `$`, ou inclua a barra: `/finalizar-compra/$`.

### Como confirmar o nome real do cookie

Cookies têm nomes exatos e plugins mudam de nome entre versões ou entre lojas. Para ver o nome real: com o carrinho cheio, aperte **F12**, abra **Aplicativo** (**Application**), depois **Cookies** e o seu domínio. Compare letra por letra com o que está na lista de exclusão.

### Por que um cache antigo ainda aparece como hit

Se a página já estava no cache antes de você criar a regra, a cópia antiga pode continuar sendo servida. Depois de qualquer alteração, vá em **LiteSpeed Cache > Ferramentas > Limpar** e use **Limpar tudo**. Então teste de novo.

### Quando a CDN responde no lugar do LiteSpeed

Se o site passa por uma CDN ou proxy, a página pode estar vindo do cache dela, não do LiteSpeed. Nesse caso a exclusão do plugin está correta e o problema está em outro lugar. Procure na resposta cabeçalhos da própria CDN (por exemplo, `cf-cache-status` no Cloudflare) e configure a exclusão lá também.

## Corrija uma regra por vez e registre o resultado

A tentação é reescrever a lista inteira. Não faça isso. Mude uma linha, salve, limpe o cache, refaça o teste daquela URL e anote o novo valor do cabeçalho na sua planilha. Se melhorou, siga para a próxima. Se não, volte a linha como estava.

Depois de corrigir as exclusões, teste também uma página que deveria continuar em cache, como a página inicial sem cookie nenhum. Ela precisa mostrar `hit` na segunda carga. Se mostrar `miss` sempre ou nenhum cabeçalho, alguma regra nova ficou larga demais e está excluindo o site todo. Volte pelo arquivo exportado.

Guarde a planilha. Da próxima vez que alguém disser que o carrinho mostrou item de outra pessoa, você tem a lista de regras, o endereço real de cada uma e o resultado do último teste. Em geral a resposta está numa linha com grafia errada, não no plugin.

