blog
WordPress

Página não atualiza no WordPress: purgar ou excluir do cache

Um mapa de sintoma para culpado no LiteSpeed Cache, com o passo clicável para desligar uma otimização por vez e o que escrever nas caixas de exceção de carrinho, checkout, minha conta e área de membros.

JR · · 13 min de leitura · 2 tabelas · 1 bloco de código

Resposta curta: página que não atualiza depois da edição normalmente é purge, não exclusão. Purgue tudo pelo menu LiteSpeed na barra do painel e recarregue em janela anônima. Se o erro voltar, use as três caixas de exceção: Do Not Cache URIs, Do Not Cache Cookies e cache privado para logado.

Neste artigo
  1. Tabela de sintoma, causa provável e primeira ação
  2. Antes de mexer, exporte as configurações e tenha um caminho de volta
  3. Purgar descarta a cópia, excluir impede de guardar
  4. Desligar as otimizações da mais arriscada para a menos arriscada
  5. As três caixas de exceção e o que escrever em cada uma
  6. Linhas de exemplo para carrinho, checkout, minha conta, membros e formulários
  7. Ler x-litespeed-cache para confirmar hit, miss ou nada
  8. CDN, navegador, outro plugin de cache e Object Cache

Você editou o texto de uma página, clicou em Atualizar, abriu o site e continua vendo a versão antiga. Ou pior: mexeu nas configurações do LiteSpeed Cache ontem e hoje o layout está sem CSS, o carrinho mostra um produto que você não colocou e um cliente reclamou de ver o nome de outra pessoa no topo.

Esses três sintomas têm causas diferentes e soluções diferentes. Trocar de plano não resolve nenhum deles. O que resolve é isolar qual camada está devolvendo conteúdo velho e, quando for o caso, escrever a URL certa na caixa de exceção certa.

Não há medição nossa neste artigo. O procedimento abaixo se apoia na documentação oficial de troubleshooting do LSCache para WordPress, que orienta justamente isolar o problema desativando recursos um a um, e na estrutura de telas do próprio plugin.

Tabela de sintoma, causa provável e primeira ação

Antes de abrir qualquer aba de configuração, leia a linha que descreve o que você está vendo. A coluna do meio é onde procurar.

Sintoma Culpado provável Onde olhar Primeira ação
Página editada continua antiga para qualquer visitante Purge não disparado LiteSpeed Cache > Toolbox > Purge Purge All e testar em janela anônima
Página antiga só no seu navegador, correta em janela anônima Cache do navegador Nada no plugin Ctrl+F5 (Cmd+Shift+R no Mac)
Site sem CSS, fontes trocadas, blocos empilhados CSS/JS Combine, Minify ou UCSS Page Optimization > CSS Settings e JS Settings Desligar Combine, purgar cache de CSS/JS
Imagens ou menu somem ao rolar a página Lazy Load Page Optimization > Media Settings Desligar Lazy Load de imagens e iframes
Carrinho com item de outra pessoa, nome de outro usuário no topo Cache público servido em URL que precisava ser privada Cache > Excludes e Cache > Cache Do Not Cache URIs e cookie de sessão
Login entra e volta para a tela de login Página de login cacheada Cache > Cache > Cache Login Page Desligar e purgar
Formulário envia e volta erro de segurança ou tela em branco Nonce expirado dentro de HTML cacheado Cache > ESI ou Cache > Excludes Excluir a URL do cache
Contador, estoque ou bloco via AJAX parado Cache REST API Cache > Cache > Cache REST API Desligar e testar
Painel administrativo estranho depois de trocar tema ou plugin Object Cache Cache > Object Desligar temporariamente
Erro 500 logo depois de salvar configuração Regra no .htaccess Arquivo .htaccess na raiz do site, pelo gerenciador de arquivos da hospedagem ou FTP Subir a cópia salva do .htaccess por cima (ver passo a passo abaixo)

Sobre a última linha: com erro 500 você não entra no wp-admin, então esqueça o painel do WordPress. Entre no painel da sua hospedagem, abra o Gerenciador de Arquivos (ou conecte por FTP com o seu cliente de FTP), navegue até a raiz do site, normalmente a pasta public_html ou public_html/nome-do-dominio, e envie a cópia do .htaccess que você baixou antes de mexer, sobrescrevendo o arquivo que está lá. Recarregue o site. Se voltou, o problema estava na regra gravada pelo plugin. Se você não tem cópia do arquivo, renomeie o .htaccess atual para .htaccess-quebrado e teste: o site pode voltar sem as regras de cache, e daí você reconstrói pelo plugin.

Duas leituras importantes dessa tabela.

Página que não atualiza depois da edição costuma ser problema de purge, não de exclusão. Você não precisa tirar essa página do cache para sempre. Você precisa que o cache dela seja descartado quando você salva.

Conteúdo de um visitante aparecendo para outro é o oposto: é exclusão mesmo. Alguma URL que carrega dado pessoal está sendo guardada como página pública, e a cópia guardada é entregue ao próximo que pedir a mesma URL.

Do sintoma à camada culpadaTestar em janela anônimaSe corrigir, era cache do navegadorPurge All no pluginConteúdo editado que não apareceLayout quebradoDesligar Combine, Minify e UCSSDado de outro usuárioExcluir URL e cookie de sessãoErro 500Restaurar cópia do .htaccessConfirmar pelo cabeçalhoLer x-litespeed-cache: hit ou miss
Caminho de diagnóstico do sintoma até a confirmação pelo cabeçalho de resposta.

Antes de mexer, exporte as configurações e tenha um caminho de volta

Mudança de configuração de cache costuma ser reversível, mas reverter no escuro é o que transforma um layout quebrado em um dia perdido.

Backup de arquivos e banco, mais uma cópia do .htaccess

Backup completo, arquivos e banco, pelo painel da hospedagem ou pelo plugin de backup que você já usa. Se o passo seguinte envolver editar .htaccess, baixe uma cópia do arquivo para o seu computador antes.

Export Settings, o arquivo que desfaz qualquer bagunça

No painel do WordPress, vá em LiteSpeed Cache > Toolbox > Import / Export e clique em Export Settings. O plugin baixa um arquivo com o estado atual de todas as opções. Se você bagunçar tudo, o botão Import Settings na mesma tela devolve exatamente o que estava antes.

Uma mudança por vez, anotada, para saber qual quebrou o site

Uma mudança por vez, testando entre uma e outra. Parece lento e é o único jeito de saber qual opção causou o quê. A documentação de troubleshooting insiste nesse ponto por um motivo prático: quem desliga cinco coisas de uma vez e o site volta ao normal não sabe qual das cinco pode ser religada.

Ordem de reversão, do Purge All até o backup

  1. Purge All (menu LiteSpeed Cache na barra superior do painel).
  2. Desligar a última opção que você ligou, purgar de novo, testar.
  3. Se ainda estiver quebrado, importar o arquivo de configurações exportado no passo 2.
  4. Se ainda estiver quebrado, desativar o plugin inteiro pelo menu Plugins e testar. Site normal com o plugin desativado confirma que a causa está nele.
  5. Só então restaurar backup.

Purgar descarta a cópia, excluir impede de guardar

Dois botões, dois efeitos diferentes, e confundi-los é o erro mais comum.

Purgar descarta a cópia guardada agora. Na próxima visita, a página é gerada de novo e guardada de novo. É o que você quer quando editou um conteúdo.

Excluir (do not cache) diz ao plugin para nunca guardar aquela URL. Toda visita passa pelo PHP. É o que você quer para carrinho, checkout e área logada, e é exatamente o que você não quer para o resto do site, porque cada URL excluída é uma URL que perdeu o ganho de cache.

Os três lugares onde purgar, e qual deles usar em cada caso

O botão Empty Entire Cache, também no Toolbox, limpa o cache no nível do servidor e não apenas do seu site. Em ambiente compartilhado, prefira o Purge All.

Desligar as otimizações da mais arriscada para a menos arriscada

Layout quebrado depois de ativar otimização quase nunca vem do cache de página. Vem da parte que reescreve CSS e JavaScript. Vá em LiteSpeed Cache > Page Optimization e desligue nesta ordem, purgando e testando em janela anônima a cada passo:

  1. CSS Settings > CSS Combine. Combinar arquivos muda a ordem de carregamento e é o que mais quebra tema com muitos plugins.
  2. JS Settings > JS Combine e, se existir no seu tema, JS Combine External and Inline.
  3. CSS Settings > Generate UCSS (CSS único: o plugin remove as regras que ele julga não usadas naquela página). Slider ou popup que só aparece depois de um clique é a vítima clássica. Atenção: Generate UCSS e Generate Critical CSS são duas caixas diferentes na mesma tela, com funções diferentes. Desligue a que você quer testar e confira o nome antes de salvar, senão você testa uma e culpa a outra.
  4. CSS Settings > Load CSS Asynchronously e JS Settings > Load JS Deferred.
  5. Media Settings > Lazy Load Images e Lazy Load Iframes.
  6. Por último, CSS Minify e JS Minify. Minificar sozinho raramente quebra, e é o que dá ganho com menor risco.

A cada desligamento: Toolbox > Purge > Purge All - CSS/JS Cache, depois recarregue o site em janela anônima. Janela anônima porque o seu navegador tem a versão velha do arquivo combinado guardada, e você vai passar meia hora testando uma coisa que já está resolvida.

Quando o layout voltar ao normal, você encontrou a opção culpada. Religue as outras uma por uma. Muita gente descobre que só o Combine atrapalhava e mantém o resto ligado.

Ordem de desligar as otimizaçõesCSS CombineMaior risco, desligue primeiroJS CombineInclui external and inlineGenerate UCSSQuebra slider e popupAsync e DeferredLoad CSS async, JS deferredMinifyMenor risco, desligue por último
Ordem de desligamento. Purgue o cache de CSS/JS e teste em janela anônima entre cada passo.

As três caixas de exceção e o que escrever em cada uma

São três lugares distintos no plugin, e escrever a coisa certa no lugar errado não produz efeito nenhum.

Do Not Cache URIs, caminho relativo e uma URL por linha

Caminho: LiteSpeed Cache > Cache > Excludes > Do Not Cache URIs.

Uma URL por linha, caminho relativo, começando com barra. Nada de https://, nada de domínio. O valor é comparado com o caminho da requisição, então /minha-conta também alcança /minha-conta/pedidos. Se você precisa casar exatamente uma página e nada abaixo dela, o plugin aceita $ no fim da linha. Na dúvida, escreva a regra, purgue e confirme pelo cabeçalho de resposta (última seção).

Cuidado com o excesso: uma linha com / exclui o site inteiro do cache.

Do Not Cache Cookies, como ler o nome exato no DevTools

Caminho: LiteSpeed Cache > Cache > Excludes > Do Not Cache Cookies.

Um nome de cookie por linha. Se o visitante tiver aquele cookie no navegador, nenhuma página é servida do cache para ele. É a rede de segurança para casos em que a URL sozinha não distingue quem é quem, como um carrinho que aparece no cabeçalho de qualquer página.

Para descobrir o nome do cookie que o seu plugin cria: abra o site logado, pressione F12, aba Application (no Chrome) ou Armazenamento (no Firefox), item Cookies, e leia os nomes na coluna da esquerda. Copie o nome exato.

Cache Logged-in Users e Private Cached URIs, duas telas diferentes

São duas telas diferentes, e é aqui que muita gente desiste achando que a opção não existe na sua versão:

Cache privado guarda uma cópia por sessão, não uma cópia para todo mundo. É o meio termo entre cachear (rápido e perigoso para conteúdo pessoal) e não cachear (seguro e lento).

Duas posturas defensáveis:

Se apareceu conteúdo de um usuário para outro, desligue o cache para logados primeiro, purgue tudo, confirme que o vazamento parou, e só depois volte a discutir desempenho.

Linhas de exemplo para carrinho, checkout, minha conta, membros e formulários

O LiteSpeed Cache traz integração com WooCommerce e com boa parte dos plugins populares, e em muitas instalações carrinho e checkout se comportam corretamente sem você escrever uma linha. Não assuma que está funcionando no seu site: rode o teste com curl da próxima seção na URL do carrinho e confirme que ela não devolve hit antes de considerar o assunto encerrado. As linhas abaixo são para quando o comportamento errado aparece, normalmente em site com tema customizado, checkout de plugin de terceiro ou permalink traduzido.

Os valores são exemplos e dependem do slug real das suas páginas. Confira em WooCommerce > Configurações > Avançado quais páginas estão definidas como carrinho, finalizar compra e minha conta, e copie o slug de lá.

Caso Caixa a usar Exemplo de conteúdo
Carrinho (instalação em português) Do Not Cache URIs /carrinho
Finalizar compra Do Not Cache URIs /finalizar-compra
Minha conta e tudo abaixo dela Do Not Cache URIs /minha-conta
Instalação em inglês Do Not Cache URIs /cart, /checkout, /my-account (uma por linha)
Sessão de loja aberta Do Not Cache Cookies nome do cookie de sessão que você leu no DevTools
Área de membros ou curso Do Not Cache URIs /area-do-aluno
Cookie do plugin de membros Do Not Cache Cookies nome do cookie de acesso lido no DevTools
Página com formulário de várias etapas Do Not Cache URIs /orcamento
Página de agradecimento com dados do pedido Do Not Cache URIs /pedido-recebido
Usuário logado com painel pessoal Cache > Cache (desligar Cache Logged-in Users) ou Cache > Excludes (Private Cached URIs) desligar a opção em Cache > Cache, ou listar a URL em Private Cached URIs, na tela Excludes

Depois de escrever qualquer linha, clique em Save Changes no topo da tela e faça um Purge All. Configuração salva sem purge continua servindo a cópia velha, e você vai achar que a regra não funcionou.

Sobre formulários: nem todo formulário precisa sair do cache. Formulário simples de contato costuma funcionar bem em página cacheada. O que quebra é o formulário cujo HTML carrega um token de segurança com validade curta, porque o token viaja congelado dentro da página guardada. Se você usa Contact Form 7, WPForms ou similar e o erro é de validação ou de sessão, duas saídas: excluir a URL daquela página pelo Do Not Cache URIs, ou declarar o nonce em LiteSpeed Cache > Cache > ESI, no campo de nonces, para que aquele pedaço seja montado a cada visita. A primeira é mais simples, a segunda preserva o cache do resto da página.

Ler x-litespeed-cache para confirmar hit, miss ou nada

Olhar a tela e achar que está certo não é teste. O servidor informa em cada resposta se aquela página veio do cache.

Pelo navegador: pressione F12, abra a aba Network, recarregue a página, clique na primeira linha (o documento HTML) e leia Response Headers. Procure por x-litespeed-cache.

Pelo terminal, se você tiver acesso a um:

curl -sI https://seusite.com.br/ | grep -i "^x-litespeed-cache:"

O que cada parte do comando faz: curl -sI pede apenas os cabeçalhos da resposta, sem baixar o HTML e sem barra de progresso; o grep -i "^x-litespeed-cache:" filtra só a linha que começa exatamente com esse nome de cabeçalho, ignorando maiúsculas e minúsculas.

O ^ e os dois-pontos no fim importam. Sem eles, o filtro também casa o cabeçalho x-litespeed-cache-control, que é outra coisa: ele informa a política de cache aplicada à resposta (por exemplo, público, privado ou sem cache) e não diz se a página veio do cache. Se aparecer x-litespeed-cache-control na sua saída, não leia esse valor como hit ou miss.

Resultado esperado:

O teste de aceitação para uma exclusão fica assim: rode o comando na URL do carrinho e confirme que não aparece hit. Rode na home e confirme que aparece hit na segunda chamada. Se a home também parou de cachear, você escreveu uma regra larga demais no Do Not Cache URIs.

Para o caso de página que não atualiza, o teste é outro: edite, salve, e rode o comando duas vezes. A primeira deve retornar miss (o purge funcionou e a cópia velha sumiu) e a segunda hit.

CDN, navegador, outro plugin de cache e Object Cache

Antes de continuar mexendo em configuração, elimine as outras camadas. A documentação de troubleshooting segue essa mesma lógica de eliminação.

Um último conselho que vai contra a tentação de mexer em tudo: quando encontrar o culpado, religue todo o resto. Site com dez URLs excluídas e todas as otimizações desligadas está tão lento quanto estava antes de você instalar o plugin, e você ainda tem a manutenção de uma lista de exceções para lembrar depois.

Referências

  1. Documentação oficial (litespeed) — LSCache for WordPress: Troubleshooting. Consultado em 2026-09-16.
Leia também