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

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

João Rizzon · 2026-09-17 · WordPress

---

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](https://docs.litespeedtech.com/lscache/lscwp/troubleshoot/), 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.

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

- Purge All (menu LiteSpeed Cache na barra superior do painel).
- Desligar a última opção que você ligou, purgar de novo, testar.
- Se ainda estiver quebrado, importar o arquivo de configurações exportado no passo 2.
- 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.
- 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

- **Barra superior do painel**, menu **LiteSpeed Cache > Purge All**: o caminho rápido, e costuma resolver a maioria dos casos de conteúdo antigo aparecendo depois de uma edição.
- **LiteSpeed Cache > Toolbox > Purge**: botões separados para **Purge All - LSCache** (o HTML) e **Purge All - CSS/JS Cache** (os arquivos combinados e minificados). Depois de editar CSS do tema ou de um plugin, o segundo é o que importa.
- **LiteSpeed Cache > Cache > Purge**: aqui ficam as **Auto Purge Rules For Publish/Update**, a lista de caixas que define o que é purgado automaticamente quando você publica ou atualiza um conteúdo. Se alguém desmarcou tudo em nome de performance, sua home nunca mais mostrou post novo. Vale conferir essa tela quando o sintoma é "a página certa atualiza, a home não".

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:

- **CSS Settings > CSS Combine**. Combinar arquivos muda a ordem de carregamento e é o que mais quebra tema com muitos plugins.
- **JS Settings > JS Combine** e, se existir no seu tema, **JS Combine External and Inline**.
- **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.
- **CSS Settings > Load CSS Asynchronously** e **JS Settings > Load JS Deferred**.
- **Media Settings > Lazy Load Images** e **Lazy Load Iframes**.
- 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.

## 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 Logged-in Users** fica em **LiteSpeed Cache > Cache > Cache**, junto com as outras chaves de liga e desliga do cache.
- **Private Cached URIs** fica em **LiteSpeed Cache > Cache > Excludes**, na mesma tela do Do Not Cache URIs, logo abaixo das caixas de exclusã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:

- **Segurança primeiro**: desligue **Cache Logged-in Users** em **Cache > Cache**. Visitante anônimo recebe cache, usuário logado recebe página gerada na hora. É a configuração que menos surpreende.
- **Desempenho com cuidado**: mantenha ligado e liste em **Cache > Excludes > Private Cached URIs** as URLs que devem ser guardadas em modo privado.

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:

- `x-litespeed-cache: hit` a página veio do cache.
- `x-litespeed-cache: miss` a página foi gerada agora e guardada para a próxima.
- **nenhuma linha de saída** a página não está sendo cacheada, ou o cache no nível do servidor não está ativo.

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](https://docs.litespeedtech.com/lscache/lscwp/troubleshoot/) segue essa mesma lógica de eliminação.

- **CDN na frente do site**. Cloudflare, QUIC.cloud ou qualquer outra guarda a própria cópia. Purgar no WordPress não purga lá. Limpe o cache no painel da CDN também, e teste com o modo de desenvolvimento ativado.
- **Cache do navegador**. Janela anônima resolve a dúvida em cinco segundos. Se o site está certo na janela anônima e errado na sua, o plugin não tem nada com isso.
- **Outro plugin de cache instalado**. Dois plugins de cache convivendo mal produzem exatamente o sintoma de página que não atualiza. Escolha um, desative o outro, purgue os dois antes.
- **Object Cache**. Em **LiteSpeed Cache > Cache > Object**, com Redis ou Memcached ligado, dado do banco também fica guardado. Desligue temporariamente se o sintoma for em painel ou em consulta dinâmica.
- **Plugin desativado como teste final**. Site com o LiteSpeed Cache desativado e o problema persistindo significa que a causa está em outro lugar: tema, outro plugin, ou configuração do servidor.

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.

