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

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

João Rizzon · 2026-10-30 · WordPress

---

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](https://docs.litespeedtech.com/lscache/lscwp/thirdparty/)). 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](https://docs.litespeedtech.com/lscache/lscwp/thirdparty/).
- 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-cache` em duas cargas: `miss` persistente na página excluída, `hit` na 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.

