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.

Resposta curta: 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`.
Neste artigo
- Os três sintomas que denunciam conflito entre plugin e cache
- Salve as configurações antes de acrescentar qualquer linha
- Prove que a página veio do cache antes de acusar o plugin
- Descubra o plugin culpado sem desligar o cache do site
- Qual exclusão aplicar para cada tipo de conflito
- Confirme que só a URL certa parou de devolver hit
- O que fazer quando a exclusão não resolve
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:
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, 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çalhox-litespeed-cachesimplesmente não aparecer na lista de cabeçalhos de resposta, ou aparecer indicando no-cache. O sinal de sucesso não é lermiss, é nunca mais lerhitali. - 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 serhit.
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:
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, consultado em 24/09/2026.
Referências
- Documentação oficial (litespeed) — LSCache Third Party Plugin Compatibility. Consultado em 2026-09-24.