blog
Infraestrutura web

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.

JR · · 7 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: 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.

Neste artigo
  1. O que a exclusão faz e qual cabeçalho prova que ela casou
  2. Antes de mexer: exporte a configuração atual
  3. Monte a lista do que deveria ficar fora
  4. Teste cada regra pelo cabeçalho
  5. Os motivos mais comuns de uma regra nunca casar
  6. Corrija uma regra por vez e registre o resultado

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

  1. No painel do WordPress, entre em LiteSpeed Cache > Ferramentas (em inglês, Toolbox).
  2. Abra a aba Importar / Exportar.
  3. 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:

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

  1. Abra uma janela anônima. Assim você não leva cookies de login, que mudam o comportamento do cache.
  2. Aperte F12 para abrir as ferramentas de desenvolvedor e clique na aba Rede (Network).
  3. Marque a caixa Desativar cache (Disable cache), para o navegador não responder sozinho.
  4. Digite o endereço que deveria estar excluído e carregue a página.
  5. Na lista, clique na primeira linha (o próprio documento) e procure a seção Cabeçalhos de resposta.
  6. 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.

Como decidir se a regra casouLimpe o cache e recarregue duas vezesUse Limpar tudo antes do testeSegunda carga mostra hit?Compare com o cabeçalho anotadoSim: a regra não casouRevise a linha com o endereço realNão: a exclusão está funcionandoConfirme também a página inicial
Como ler o resultado do teste de uma regra de exclusão.

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/$.

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.

Ciclo seguro de correção de uma regraMude uma linha da listaSó uma alteração por vezLimpe o cacheLiteSpeed Cache > Ferramentas > Limpar tudoTeste a URL pelo cabeçalhoDuas cargas, anote o valorRegistre na planilhaMantenha ou volte a linha anterior
Ciclo de correção: uma regra por vez, com registro do resultado.

Referências

  1. Documentação oficial (litespeed) — LSCache: Verify Cache Exclusions. Consultado em 2026-11-13.
Leia também