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.

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
- Por que o cache quebra justamente esses três plugins
- Duas checagens que evitam trabalho à toa
- Os quatro tipos de exclusão e o que cada um realmente apaga
- Qual exclusão aplicar para cada um dos três sintomas
- Como ler HIT e MISS no DevTools e provar que só a exceção saiu
- Erros que fazem a correção parecer que não funcionou
- 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.
- Construtor de página (Elementor, Divi, Beaver, WPBakery): o editor roda em uma URL própria, normalmente com um parâmetro na query string, e precisa de resposta fresca a cada clique. Se essa URL for cacheada, você edita e vê a versão antiga, ou o editor nem carrega.
- Formulário com nonce: o WordPress gera um token de segurança embutido no HTML da página e válido por tempo limitado. Se o HTML foi salvo em cache ontem, o token entregue hoje já venceu, e o WordPress recusa o envio.
- Plugin de tradução: a língua escolhida costuma viver em um cookie. Se o cache ignora o cookie, a primeira versão gerada (digamos, português) é servida também para quem escolheu inglês.
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
- URI: escreva o caminho a partir da barra, por exemplo
/orcamento/. Uma linha por caminho. - Query string: escreva só o nome do parâmetro, sem o valor e sem o
?. - Cookie: escreva só o nome do cookie, sem o valor.
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.
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
- Abra uma janela anônima (cache de usuário logado se comporta de outro jeito).
- Pressione F12 para abrir o DevTools e clique na aba Network.
- Marque Disable cache (isso desliga o cache do navegador, não o do servidor: você quer ver o que o servidor responde).
- Carregue a URL. Clique na primeira linha da lista, a do próprio documento HTML, não em imagem ou script.
- 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.
Erros que fazem a correção parecer que não funcionou
- Não limpar o cache depois de salvar a regra. A cópia antiga continua sendo servida. Toolbox → Purge All.
- Testar logado. Você vê sempre conteúdo fresco e conclui que resolveu.
- Usar CDN ou proxy na frente. Se há outra camada de cache (CDN, proxy do provedor, plugin de cache concorrente), a exclusão no WordPress não a alcança. Ative o cache de um lugar só.
- Excluir por cookie quando bastava URI. Custa desempenho no site todo em troca de consertar uma página.
- Dois plugins de cache ativos. Escolha um. Dois gerando página salva produzem sintomas que nenhuma regra explica.
O checklist em ordem, do diagnóstico à documentação
- Reproduza o erro em janela anônima e confirme que logado funciona.
- Purge All e teste de novo, pode ser só cópia velha.
- Consulte a lista de compatibilidade de plugins de terceiros do LSCache.
- Identifique o que carrega o estado: URI, parâmetro na query string ou cookie, olhando a aba Network.
- Crie a regra mais estreita possível em Cache → Excludes.
- Purge All.
- Verifique
x-litespeed-cacheem duas cargas:misspersistente na página excluída,hitna segunda carga da home. - 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
- Documentação oficial (litespeed) — LSCache Third Party Plugin Compatibility. Consultado em 2026-09-24.