blog
WordPress

Plugin quebrou depois do cache: como excluir só ele

Construtor de página, formulário com nonce e plugin de tradução quebram pelo mesmo motivo. O conserto é uma exclusão no lugar certo, verificada pelo cabeçalho de resposta.

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

Resposta curta: o conserto é criar uma exclusão específica em LiteSpeed Cache → Cache → Excludes, escolhendo entre quatro tipos (URI, query string, cookie ou user agent), limpar o cache e confirmar no cabeçalho x-litespeed-cache que a página excluída dá miss e o resto do site segue dando hit.

Neste artigo
  1. Por que o cache quebra justamente esses três plugins
  2. Duas checagens que evitam trabalho à toa
  3. Os quatro tipos de exclusão e o que cada um realmente apaga
  4. Qual exclusão aplicar para cada um dos três sintomas
  5. Como ler HIT e MISS no DevTools e provar que só a exceção saiu
  6. Erros que fazem a correção parecer que não funcionou
  7. O checklist em ordem, do diagnóstico à documentação

Depois de ativar um plugin de cache, três quebras aparecem quase sempre com a mesma cara: o construtor de página abre em branco ou salva e não aplica, o formulário devolve "erro de segurança" ou "link expirado", e o site traduzido mostra a língua errada para quem chega pela segunda vez. Nos três casos o código do plugin continua intacto. O que mudou é que a resposta entregue ao navegador veio de uma cópia guardada, feita para outro visitante, em outro momento.

A correção não é desligar o cache do site inteiro. É excluir do cache exatamente a URL, o cookie ou o parâmetro que carrega estado, e depois provar pelo cabeçalho de resposta que só aquilo ficou de fora. Este guia é documental: as telas descritas aqui são as do LiteSpeed Cache 6.x no painel do WordPress, e nomes de abas e campos podem mudar entre versões, então confira na sua instalação antes de procurar item por item. A documentação oficial é citada só no ponto que ela cobre, a lista de compatibilidade com plugins de terceiros. Nenhum teste de laboratório foi feito para este artigo, e nenhum número de desempenho é afirmado aqui.

Por que o cache quebra justamente esses três plugins

Uma página cacheada é um arquivo salvo com a resposta pronta. O servidor entrega esse arquivo a quem pedir a mesma URL, sem rodar o PHP de novo. Isso é ótimo para um post de blog e péssimo para qualquer coisa que dependa de quem está pedindo ou de quando está pedindo.

O padrão comum: conteúdo que varia por usuário, por sessão ou por tempo curto não pode compartilhar a mesma cópia.

Duas checagens que evitam trabalho à toa

Confirme que o culpado é o cache, e não um conflito de plugin

Abra a página problemática em uma janela anônima e também logado no painel. Usuários logados normalmente não recebem página cacheada. Se funciona logado e quebra deslogado, é cache. Se quebra nos dois, provavelmente é conflito de plugin ou erro de PHP, e exclusão de cache não resolve.

Veja se o seu plugin já tem tratamento nativo no LSCache

O LiteSpeed Cache mantém uma lista pública de plugins de terceiros com compatibilidade já implementada, incluindo o tratamento específico que cada um recebe (LSCache Third Party Plugin Compatibility). Vale consultar antes de criar regra manual: se o seu plugin está lá, a exclusão que você ia escrever pode já existir, e a quebra pode ser só uma versão desatualizada ou um cache antigo que nunca foi limpo.

Limpe tudo antes de testar: LiteSpeed Cache → Toolbox → Purge → Purge All. Metade dos "não resolveu" é página velha ainda guardada.

Os quatro tipos de exclusão e o que cada um realmente apaga

As regras ficam em LiteSpeed Cache → Cache → aba Excludes no painel do WordPress (nomes conforme a versão 6.x; em versões mais antigas os campos existem com rótulos parecidos, em outra ordem). Cada campo aceita uma entrada por linha. A diferença entre eles não é estilo, é escopo.

Campo na aba Excludes O que você escreve O que deixa de ser cacheado Use quando
Do Not Cache URIs Caminho da URL, uma por linha Só aquele caminho (e o que estiver sob ele, conforme a regra) Página de formulário, checkout, área de membro, URL do editor
Do Not Cache Query Strings Nome do parâmetro Qualquer URL que contenha aquele parâmetro Editor do construtor, pré-visualização, links com token na URL
Do Not Cache Cookies Nome do cookie Qualquer visita que chegue com aquele cookie presente Idioma, moeda, sessão de app, teste A/B
Do Not Cache User Agents Trecho do user agent Visitas daquele navegador ou bot Casos raros, app próprio, ferramenta de teste

Regra prática de escopo: cookie é o mais amplo, porque desliga o cache para a navegação inteira daquele visitante. URI é o mais cirúrgico. Comece pelo mais estreito que resolve o sintoma.

Como escrever cada entrada sem errar o formato

Depois de salvar, faça Purge All de novo. Regra nova não apaga sozinha o que já estava guardado.

Qual exclusão aplicar para cada um dos três sintomas

Os exemplos abaixo são ilustrativos e seguem o padrão de cada família de plugin. Confirme o nome real do parâmetro e do cookie no seu site antes de copiar, usando a aba Network do navegador (próxima seção explica como).

Sintoma Tipo de exclusão Entrada (exemplo a confirmar no seu site)
Editor do construtor abre em branco ou não salva Query string o parâmetro que aparece na URL ao abrir o editor
Formulário com "link expirado" ou erro de nonce URI /contato/ e qualquer página que só exista para enviar formulário
Tradução mostra a língua errada no segundo acesso Cookie o cookie de idioma que o plugin grava

No caso do formulário, existe uma alternativa quando a página precisa ficar cacheada por ser muito visitada: o LiteSpeed Cache tem a seção Cache → ESI, que permite servir a maior parte da página do cache e montar só um bloco dinamicamente. É mais trabalho e exige que o plugin coopere. Se a página de contato não tem tráfego relevante, excluí-la inteira é a escolha certa e mais simples.

Do sintoma à regra de exclusão certaQuebra só deslogadoConfirme em janela anônimaEditor do construtor falhaExcluir parâmetro da query stringFormulário com link expiradoExcluir a URI da páginaIdioma errado no segundo acessoExcluir o cookie de idiomaSalvou a regraToolbox, Purge All de novo
Comece pela regra mais estreita que resolve o sintoma: URI é cirúrgico, cookie desliga o cache da navegação inteira.

Como ler HIT e MISS no DevTools e provar que só a exceção saiu

Esta é a parte que a maioria pula, e é a única que transforma palpite em conserto verificado.

Onde encontrar o cabeçalho x-litespeed-cache no navegador

  1. Abra uma janela anônima (cache de usuário logado se comporta de outro jeito).
  2. Pressione F12 para abrir o DevTools e clique na aba Network.
  3. Marque Disable cache (isso desliga o cache do navegador, não o do servidor: você quer ver o que o servidor responde).
  4. Carregue a URL. Clique na primeira linha da lista, a do próprio documento HTML, não em imagem ou script.
  5. Em Headers → Response Headers, procure a linha x-litespeed-cache.

O que esperar:

x-litespeed-cache: miss    → gerada agora, não veio do cache
x-litespeed-cache: hit     → veio do cache

Em páginas excluídas o cabeçalho pode simplesmente não aparecer, o que também indica que a página não foi cacheada.

As duas cargas que confirmam que o resto do site segue cacheado

Recarregue duas vezes cada URL e anote:

URL 1ª carga 2ª carga Leitura
Página excluída (resultado esperado) miss / ausente miss / ausente Correto, exclusão funcionando
Home e posts miss hit Correto, resto do site segue cacheado
Página excluída (resultado errado) miss hit Regra errada ou cache não foi limpo
Home miss miss Exclusão ampla demais, revise o cookie

O erro mais comum é o da última linha: alguém exclui um cookie que todo visitante recebe e desliga o cache do site inteiro sem perceber, porque o sintoma original some e ninguém confere a home.

Se preferir terminal, o mesmo cabeçalho sai com um comando só:

curl -sI https://seusite.com.br/ | grep -i litespeed

O -s silencia a barra de progresso, o -I pede só os cabeçalhos, e o grep -i filtra ignorando maiúsculas. Rode duas vezes seguidas: a segunda deve mostrar hit numa página normal.

Como provar a exclusão pelo cabeçalho de respostaJanela anônimaF12, aba Network, Disable cachePrimeira linhaClique no documento HTMLResponse HeadersProcure x-litespeed-cacheDuas cargasRecarregue a mesma URLLeituraPágina excluída miss, home hit
Em páginas excluídas o cabeçalho pode nem aparecer, o que também indica que a página não foi cacheada.

Erros que fazem a correção parecer que não funcionou

O checklist em ordem, do diagnóstico à documentação

  1. Reproduza o erro em janela anônima e confirme que logado funciona.
  2. Purge All e teste de novo, pode ser só cópia velha.
  3. Consulte a lista de compatibilidade de plugins de terceiros do LSCache.
  4. Identifique o que carrega o estado: URI, parâmetro na query string ou cookie, olhando a aba Network.
  5. Crie a regra mais estreita possível em Cache → Excludes.
  6. Purge All.
  7. Verifique x-litespeed-cache em duas cargas: miss persistente na página excluída, hit na segunda carga da home.
  8. Documente a regra em um bloco de notas do site. Daqui a seis meses você não vai lembrar por que aquela linha está ali.

Se depois disso a página excluída ainda mostra hit, o cache não está vindo do plugin do WordPress, e o próximo lugar a olhar é a camada acima: CDN, proxy ou configuração no painel de hospedagem.

Referências

  1. Documentação oficial (litespeed) — LSCache Third Party Plugin Compatibility. Consultado em 2026-09-24.
Leia também