# Carrinho não atualiza com cache: exclua a URL, não o cache

Como achar o plugin que briga com o cache, aplicar a exclusão certa por URL, cookie ou query string, e verificar na aba Rede que só a página problemática deixou de ser cacheada.

> três sintomas identificam o conflito entre plugin e cache no WordPress: carrinho que não soma, construtor que salva e não mostra, e formulário com token expirado. A correção é excluir só a URL afetada, não desligar o cache do site, e confirmar no DevTools que ela nunca mais devolve `hit`.

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

---

Cache e carrinho brigam por um motivo simples: o cache serve uma cópia pronta da página para todo mundo, e o carrinho precisa de uma página diferente para cada visitante. Quando o plugin de cache guarda a versão errada, o produto some, o total não muda e o cliente desiste.

A reação mais comum é desligar o cache inteiro. Funciona, e custa o site inteiro ficar lento para resolver um problema de duas URLs. O caminho melhor é isolar: descobrir qual página (ou qual plugin) precisa escapar do cache, aplicar a exclusão exata e deixar o resto cacheado.

## Os três sintomas que denunciam conflito entre plugin e cache

Conflitos entre plugin e cache costumam cair em um destes três padrões. Reconhecer o padrão já aponta o tipo de exclusão a aplicar.

| Sintoma na tela | O que o cache está fazendo | Tipo de exclusão provável |
|---|---|---||
| Carrinho mostra 0 itens, ou mostra itens de outra sessão, e o total não muda ao adicionar produto | Serviu uma cópia estática de uma página que depende da sessão do visitante | Exclusão por URL (`/carrinho`, `/finalizar-compra`, `/minha-conta`) e por cookie de sessão |
| Construtor visual (Elementor, Divi, Beaver) salva sem erro, mas o site continua mostrando o layout antigo | A página pública veio do cache; o conteúdo novo está no banco, não na cópia | Purgar a URL editada e excluir as rotas de edição/preview |
| Formulário retorna "link expirado", "erro de segurança" ou falha silenciosa no envio | O nonce do WordPress veio dentro do HTML cacheado e já venceu | Exclusão da URL do formulário ou tratamento de nonce/AJAX |

O terceiro caso é o mais confuso porque o erro não diz "cache". O nonce é um token temporário que o WordPress embute no HTML para provar que o envio veio do seu site. Se o HTML foi gerado às 9h e entregue às 15h pelo cache, o token já não vale.

## Salve as configurações antes de acrescentar qualquer linha

Toda alteração aqui é reversível, mas só se você souber o que havia antes.

- Faça backup do site (arquivos e banco). Se usa um plugin de backup, rode um backup manual agora e confirme que ele terminou.
- No painel do WordPress, entre em **LiteSpeed Cache > Kit de ferramentas** (Toolbox) e exporte as configurações. Isso gera um arquivo que devolve tudo ao estado atual se você se perder.
- Anote (print serve) o conteúdo atual dos campos de exclusão antes de acrescentar linha.

Se alguma coisa quebrar no meio do processo, o caminho de volta é: restaurar as configurações exportadas, purgar tudo e recarregar.

## Prove que a página veio do cache antes de acusar o plugin

Antes de abrir o painel de exclusões, prove que a página problemática está sendo servida do cache. O teste leva menos de um minuto.

### Janela anônima mostrando o carrinho de outra sessão

Abra a página do carrinho logado normalmente, adicione um produto. Depois abra a mesma URL em janela anônima. Se a anônima mostrar o produto que você adicionou na outra sessão, está servindo cópia compartilhada: é cache.

### O cabeçalho x-litespeed-cache na aba Rede do DevTools

- Na página problemática, pressione **F12** (ou botão direito, Inspecionar) e vá na aba **Rede** (Network).
- Marque a caixa **Desabilitar cache** (Disable cache) para tirar o cache do navegador da equação. Você quer ver o cache do servidor, não o do Chrome.
- Recarregue com **Ctrl+F5**.
- Clique na primeira linha da lista, a que tem o mesmo nome do documento, e abra **Cabeçalhos** (Headers) > **Cabeçalhos de resposta** (Response Headers).

Procure o cabeçalho `x-litespeed-cache`. O valor `hit` significa que a resposta veio do cache do servidor. O valor `miss` significa que foi gerada na hora pelo PHP.

O mesmo teste pelo terminal, se preferir:

```bash
curl -sI https://seudominio.com.br/carrinho/ | grep -i litespeed
```

Resultado esperado antes da correção, em uma página que não deveria estar cacheada:

```
x-litespeed-cache: hit
```

Se o cabeçalho não aparece de jeito nenhum, pode haver uma CDN ou um proxy na frente reescrevendo cabeçalhos. Nesse caso teste direto no IP do servidor ou desative o proxy temporariamente.

## Descubra o plugin culpado sem desligar o cache do site

A tentação é desativar o plugin de cache, ver que funciona e concluir "é o cache". Isso não te diz qual plugin está brigando, e você volta ao ponto de partida na próxima vez.

O roteiro de isolamento:

- **Liste as URLs que falham.** Carrinho, checkout, página do formulário, painel de um plugin de associação. Anote o caminho exato, como `/carrinho/` ou `/contato/`.
- **Exclua só essas URLs do cache** (passo a passo na próxima seção) e purgue.
- **Teste de novo.** Se o sintoma some, o conflito é daquela rota: resolvido, e o resto do site segue cacheado.
- **Se o sintoma continua em páginas diversas**, aí sim o conflito é mais amplo. Desative os plugins um a um, com o cache ligado, purgando entre cada teste. O plugin que, ao ser desativado, faz o sintoma sumir é o candidato.
- **Antes de culpar qualquer plugin, consulte a lista oficial.** A documentação do LiteSpeed mantém uma página de compatibilidade com plugins de terceiros em [docs.litespeedtech.com/lscache/lscwp/thirdparty](https://docs.litespeedtech.com/lscache/lscwp/thirdparty/), com casos já conhecidos e o tratamento recomendado para cada um. Vale olhar ali antes de inventar exclusão.

Risco do passo 4: desativar plugin em loja de produção derruba carrinho e checkout enquanto o teste dura, e pedido iniciado nesse intervalo pode falhar. Faça em staging, se você tem uma cópia do site. Se só existe produção, escolha o horário de menor movimento, desative um plugin por vez e reative logo depois de olhar a tela. O caminho de volta é sempre o mesmo: reativar o plugin, purgar tudo e recarregar a página em janela anônima para confirmar que voltou ao normal.

Um detalhe que economiza tempo: purgue o cache entre cada teste. Testar sem purgar faz você medir a cópia antiga e concluir errado.

## Qual exclusão aplicar para cada tipo de conflito

No painel do WordPress, vá em **LiteSpeed Cache > Cache** e procure a aba **Excluir** (Exclude). Cada campo resolve um tipo diferente de conflito.

Os nomes de campo abaixo são os que aparecem no painel do LiteSpeed Cache na prática, e variam conforme a versão do plugin e o idioma instalado. Confira na sua tela: se o rótulo estiver diferente, procure o campo com a mesma descrição. A documentação citada no fim deste artigo trata de compatibilidade com plugins de terceiros, não da nomenclatura dos campos.

### Excluir por URL quando a página inteira precisa vir fresca

Use quando páginas específicas precisam sempre vir frescas: carrinho, checkout, área do cliente, página de formulário com token.

No campo **Não armazenar URIs em cache** (Do Not Cache URIs), uma URL por linha, usando o caminho sem o domínio. Exemplo fictício, ajuste para os slugs do seu site:

```
/carrinho
/finalizar-compra
/minha-conta
```

Salve e purgue tudo em **LiteSpeed Cache > Kit de ferramentas > Limpar tudo**.

### Excluir por cookie quando o problema é o estado do visitante

Use quando o problema não é uma URL fixa, e sim um estado do visitante: usuário logado em área de membros, carrinho que aparece no cabeçalho de qualquer página, plugin que marca sessão por cookie próprio.

No campo **Não armazenar cookies em cache** (Do Not Cache Cookies), coloque o nome do cookie, um por linha. Para descobrir o nome: DevTools, aba **Aplicativo** (Application) > **Cookies**, com o estado reproduzido (logado, com item no carrinho). Compare com a lista em janela anônima e veja qual cookie só existe no estado problemático.

### Excluir por query string quando o parâmetro muda o conteúdo

Use quando a mesma página se comporta diferente conforme um parâmetro na URL, como `?preview=true`, `?add-to-cart=123` ou filtros de busca que viram páginas cacheadas distintas e inflam o cache sem necessidade.

Nas versões atuais existe um campo do tipo **Drop Query String**, que manda ignorar certos parâmetros ao montar a chave do cache, além das opções de exclusão por query. Use ignorar para parâmetros de rastreamento, e exclusão para parâmetros que mudam o conteúdo de verdade.

### Tabela de decisão entre os cinco campos de exclusão

| Situação | Campo a usar |
|---|---||
| Página inteira nunca deve ser cacheada | Não armazenar URIs em cache |
| Conteúdo muda conforme sessão/login do visitante | Não armazenar cookies em cache |
| Parâmetro na URL muda o conteúdo entregue | Exclusão por query string |
| Parâmetro de rastreamento só suja a chave de cache | Drop Query String |
| Um papel de usuário específico nunca deve ver cache | Não armazenar funções em cache (roles) |

## Confirme que só a URL certa parou de devolver hit

Exclusão aplicada sem verificação é exclusão que você vai refazer daqui a um mês. Faça a conferência em duas URLs.

- Purgue tudo.
- Abra a URL excluída (`/carrinho/`, por exemplo) com o DevTools na aba **Rede** e **Desabilitar cache** marcado. Recarregue duas vezes seguidas. Atenção ao critério: em URL excluída por Do Not Cache URIs, o normal é o cabeçalho `x-litespeed-cache` simplesmente não aparecer na lista de cabeçalhos de resposta, ou aparecer indicando no-cache. O sinal de sucesso não é ler `miss`, é nunca mais ler `hit` ali.
- Abra uma URL que deve seguir cacheada, como a página inicial ou um post. Recarregue duas vezes. A primeira pode ser `miss`, a segunda precisa ser `hit`.

Se a home também parou de entregar `hit`, a regra de exclusão ficou larga demais: um `/` solto ou um curinga pegando o site inteiro. Revise a linha, apague o excesso, purgue e teste de novo.

A verificação equivalente em duas linhas de terminal:

```bash
curl -sI https://seudominio.com.br/ | grep -i x-litespeed-cache
curl -sI https://seudominio.com.br/carrinho/ | grep -i x-litespeed-cache
```

A primeira linha deve responder `x-litespeed-cache: hit` (na segunda execução, depois de a home ter sido cacheada). A segunda pode não devolver nenhuma linha, e isso é o resultado correto: o `grep` não encontra o cabeçalho porque ele não foi enviado. Se a segunda devolver `hit`, a exclusão não pegou.

## O que fazer quando a exclusão não resolve

Algumas situações não se resolvem com exclusão de URL, e insistir só piora a performance.

- **Conteúdo dinâmico dentro de página estática.** Um "olá, Fulano" ou um contador de carrinho no cabeçalho de todas as páginas. Excluir o site inteiro do cache por causa disso é desperdício. O caminho é fazer esse trecho carregar por AJAX ou usar ESI, recurso que cacheia a página e deixa um buraco dinâmico. Antes de procurar ESI no painel, confirme o servidor: ESI depende de LiteSpeed Enterprise ou de QUIC.cloud e não funciona em OpenLiteSpeed. Em OpenLiteSpeed, sobra o caminho do AJAX.
- **Plugin com incompatibilidade conhecida.** Consulte a página de compatibilidade com plugins de terceiros do LiteSpeed antes de criar regra própria. Quando o caso já está documentado, o tratamento recomendado é mais confiável que improviso.
- **Erro que persiste com o cache desativado.** Se você desativou o plugin de cache, purgou, limpou o cache do navegador e o sintoma continua, o cache não é a causa. Olhe o log de erro do PHP e o console do navegador: conflito de JavaScript entre plugins produz sintoma muito parecido com cache travado.
- **Otimização de JS/CSS mascarada de cache.** Combinar e adiar JavaScript quebra formulário e construtor com frequência, e o dono do site culpa o cache de página. Teste desligando só as otimizações de JS, mantendo o cache de página ligado. Se resolver, o problema era ali.

Uma última recomendação contra o óbvio: não aplique uma lista de exclusões copiada de um fórum. Cada linha a mais é uma página que deixa de ser cacheada no seu site. Exclua o que você conseguiu reproduzir como quebrado, confirme no DevTools, e pare por aí.

**Fonte consultada:** LiteSpeed Technologies, LSCache Third Party Plugin Compatibility, [docs.litespeedtech.com/lscache/lscwp/thirdparty](https://docs.litespeedtech.com/lscache/lscwp/thirdparty/), consultado em 24/09/2026.

