# Como ligar cache no WooCommerce sem quebrar o carrinho

As quatro rotas que precisam sair do cache antes de ligar, o que fazer com o mini carrinho que fica congelado no topo e como confirmar tudo na aba Rede do navegador.

> antes de ativar, tire quatro rotas do cache: carrinho, finalizar compra, minha conta e os endpoints da conta (pedidos, endereços, downloads, confirmação de pedido). Depois trate o mini carrinho do topo com ESI ou AJAX e confirme na aba Rede: categoria com hit, checkout sem cache.

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

---

## Backup e caminho de volta antes do primeiro clique

Ligar cache de servidor numa loja é uma mudança que afeta o que o visitante vê, não só a velocidade. Se der errado, o sintoma clássico é o cliente adicionar produto e o carrinho continuar mostrando zero itens, ou pior, ver o carrinho de outra pessoa.

Faça duas coisas antes de qualquer clique:

- **Backup completo** (arquivos e banco). Qualquer plugin de backup serve, desde que você saiba restaurar. Se você nunca restaurou um backup, esse é o momento de testar em um ambiente de teste, não durante a configuração do cache.
- **Saiba o caminho de volta.** No LiteSpeed Cache, o desligamento fica em `LiteSpeed Cache > Cache > aba Cache > Ativar Cache`. Mude para **OFF** e salve. A partir daí nenhuma página nova é servida do cache.

Depois de desligar, limpe o que já ficou armazenado em `LiteSpeed Cache > Painel` ou no menu do topo (o ícone do plugin, opção **Purgar tudo**). Desligar sem purgar deixa cópias antigas de lado por algum tempo, dependendo da configuração do servidor.

Não faça a primeira configuração em horário de pico de vendas. Faça quando você puder navegar na loja como visitante por uns 20 minutos sem pressa.

## As quatro rotas que precisam ficar fora do cache

Uma loja WooCommerce tem páginas públicas iguais para todo mundo (home, categoria, produto) e páginas que mostram dados de uma pessoa específica. Só as primeiras podem ser servidas do cache.

A documentação oficial do LSCache for WordPress, na página de compatibilidade com plugins de terceiros, descreve o WooCommerce como suportado pelo plugin, que já traz tratamento próprio para as páginas dinâmicas da loja ([LSCache for WordPress: Third-Party Plugin Compatibility](https://docs.litespeedtech.com/lscache/lscwp/thirdparty/)). Mesmo assim, vale conferir e, se necessário, declarar as exclusões na mão, porque lojas com páginas renomeadas ou traduzidas fogem do padrão.

As quatro rotas são estas:

| Rota | Slug padrão em instalação em inglês | O que ela mostra | Pode ser cacheada |
|---|---|---|---||
| Carrinho | `/cart/` | Itens que **aquele** visitante adicionou | Não |
| Finalizar compra | `/checkout/` | Endereço, frete e pagamento do visitante | Não |
| Minha conta | `/my-account/` | Login, dados pessoais | Não |
| Endpoints da conta e da finalização | `/my-account/orders/`, `/my-account/edit-address/`, `/my-account/downloads/`, `/checkout/order-received/` | Pedidos, endereços, downloads e a confirmação de compra com o número do pedido | Não |

Os endpoints são os mais esquecidos. O WooCommerce não cria uma página separada para cada área da conta nem para a confirmação do pedido: ele usa **endpoints**, que são pedaços de URL pendurados na página Minha conta ou na de finalização. Como a exclusão do LiteSpeed Cache casa pelo início do caminho, excluir a página Minha conta já cobre os endpoints dela, e excluir a página de finalização já cobre a confirmação de pedido. A ressalva é a loja que usa slug fora do padrão nesses endpoints, ou página separada para a confirmação: aí a linha específica precisa entrar na lista.

### Onde conferir os slugs reais da sua loja

Não presuma os caminhos. Em loja em português é comum ver `/carrinho/`, `/finalizar-compra/` e `/minha-conta/`.

- Vá em `WooCommerce > Configurações > Avançado`. No topo aparecem **Página do carrinho**, **Página de finalização** e **Página da conta**. Anote as três.
- Na mesma tela, role até **Endpoints da conta** e **Endpoints de finalização de compra**. Anote cada valor (por exemplo `orders`, `edit-address`, `downloads`, `order-received`).
- Abra cada página no navegador e copie a URL da barra de endereço. É esse texto, e não o nome do menu, que vai nas exclusões.

Na tela você deve terminar com uma lista escrita, algo como: `/carrinho/`, `/finalizar-compra/`, `/minha-conta/` e os endpoints anotados.

## Como declarar a exclusão no LiteSpeed Cache

- Acesse `LiteSpeed Cache > Cache` e abra a aba **Não armazenar URIs em cache** (em inglês, **Do Not Cache URIs**).
- Cole um caminho por linha, começando com a barra, sem o domínio. Exemplo baseado numa loja em português:

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

- Clique em **Salvar alterações**. A tela recarrega e os caminhos aparecem na caixa, um por linha.
- Purgue tudo em `LiteSpeed Cache > Painel > Purgar tudo`. Na tela aparece a confirmação de que o cache foi limpo.

A quarta linha é redundante enquanto o endpoint de confirmação ficar pendurado na página de finalização, já que o campo faz correspondência pelo início do caminho: `/minha-conta` cobre `/minha-conta/pedidos/` e `/finalizar-compra` cobre a confirmação. Ela está aí porque custa nada e protege o caso em que a loja usa outro slug ou página separada para a confirmação de pedido. Linha a mais nessa caixa custa desempenho só naquela URL; linha a menos custa um carrinho errado para o cliente.

### Se o cache é de outro plugin ou do próprio servidor

O conceito é o mesmo e o campo muda de nome: "Never cache page", "Páginas nunca em cache", "Bypass URLs". Procure um campo que aceite caminhos e coloque as mesmas rotas. Se o cache é do servidor e não do plugin, peça ao suporte da sua hospedagem para aplicar a exclusão nas quatro rotas: é uma regra padrão e qualquer painel de hospedagem com cache de página tem onde colocar.

## Por que o mini carrinho do topo é o problema de verdade

As quatro exclusões resolvem as páginas inteiras. Sobra o widget de carrinho que fica no cabeçalho, aquele "0 itens, R$ 0,00". Ele aparece dentro de páginas que **são** cacheadas, como a home e as categorias. Se a página inteira foi guardada com "0 itens", todo visitante vai ver zero, mesmo com três produtos adicionados.

Existem dois caminhos e eles não são equivalentes.

### ESI, o bloco dinâmico dentro de uma página cacheada

ESI (Edge Side Includes) é um recurso do servidor web que monta trechos dinâmicos na hora de entregar uma página guardada: você marca um pedaço do HTML como "este trecho não entra no cache, monte na hora". O resto da página continua sendo servido do cache. O LiteSpeed Cache tem a aba **ESI** em `LiteSpeed Cache > Cache`, com a opção de ativar ESI e uma lista de blocos a tornar dinâmicos (o widget do carrinho costuma estar entre eles, configurável em `Aparência > Widgets`, onde cada widget ganha um bloco **LiteSpeed Cache** com a opção de ativar ESI).

Para descobrir se o seu servidor entrega ESI, há dois caminhos verificáveis. Na tela: se a aba **ESI** aparecer com a opção desabilitada, com aviso de indisponibilidade, ou se o bloco LiteSpeed Cache do widget não oferecer a opção, o recurso não está disponível. No comportamento: ative ESI na aba, ative o bloco no widget do carrinho, purgue tudo e faça o teste das duas janelas anônimas descrito adiante; se o número do mini carrinho não acompanhar o que você adicionou, o caminho não está funcionando. Em caso de dúvida, pergunte ao suporte da sua hospedagem se o servidor web da sua conta processa ESI.

Vantagem: a página de categoria continua inteira no cache. Custo: ESI depende do servidor web suportar o recurso, e a montagem do bloco dinâmico ainda executa PHP a cada visita. É o caminho mais fiel ao comportamento do WooCommerce.

### AJAX, o mini carrinho atualizado depois do carregamento

Aqui a página é cacheada com o mini carrinho vazio e um script no navegador pede o conteúdo atual logo depois do carregamento, substituindo o trecho. Temas modernos e alguns plugins de carrinho lateral já fazem isso por padrão.

Vantagem: não depende de ESI. Custo: o visitante vê "0 itens" por uma fração de segundo antes da troca, e se o script falhar o número fica errado sem aviso.

### Como escolher entre ESI e AJAX

- Se seu tema já atualiza o mini carrinho sozinho ao adicionar produto sem recarregar a página, teste primeiro sem mexer em nada. Pode ser que já esteja resolvido.
- Se o número só muda ao recarregar, ative ESI para o widget do carrinho.
- Se ESI não estiver disponível no seu servidor (conforme a checagem na aba ESI ou a resposta da hospedagem), a saída é o caminho AJAX, via tema ou plugin de carrinho que ofereça essa atualização.

Em qualquer um dos casos, teste como visitante anônimo. Logado como administrador você normalmente não recebe página do cache, então tudo parece funcionar.

## Como confirmar na aba Rede que categoria dá HIT e checkout não

Esta é a parte que fecha a configuração. Você não precisa confiar no painel do plugin: dá para ver o cabeçalho que o servidor manda.

### Abrir a loja numa janela anônima

Abra uma janela anônima (Ctrl+Shift+N no Chrome, Ctrl+Shift+P no Firefox) e vá até uma página de categoria. Janela anônima garante que você não está logado.

### Abrir a aba Rede e desabilitar o cache do navegador

Pressione F12, clique em **Rede** (Network) e marque **Desabilitar cache** (Disable cache). Isso desliga o cache do **navegador**, não o do servidor, que é justamente o que queremos observar.

### Recarregar e achar a linha do documento HTML

Recarregue a página (F5). Na lista, a primeira linha é o documento HTML, com o nome da URL e tipo `document`. Clique nela e vá em **Cabeçalhos** (Headers), seção **Cabeçalhos de resposta** (Response Headers).

### Ler o cabeçalho de cache e entender hit e miss

Procure um cabeçalho cujo nome contenha `cache`. Em servidor LiteSpeed o nome é `x-litespeed-cache` e o valor costuma ser `hit` ou `miss`. Exemplo de resposta de uma categoria servida do cache:

```
HTTP/2 200
content-type: text/html; charset=UTF-8
x-litespeed-cache: hit
```

Na primeira visita depois de purgar, é normal ver `miss`: a cópia ainda não existia. Recarregue uma segunda vez e o valor deve virar `hit`. Se continuar `miss` em toda recarga, alguma coisa está impedindo o armazenamento daquela URL (cookie, exclusão ampla demais, plugin conflitante).

### Repetir a leitura no carrinho e no checkout

Adicione um produto, vá para `/carrinho/` e depois para `/finalizar-compra/`, sempre com a aba Rede aberta. Nessas duas URLs o cabeçalho de cache **não deve indicar hit**. Dependendo da configuração, ele aparece com valor de ausência de cache ou simplesmente não aparece. Qualquer um dos dois está correto.

### O teste das duas janelas anônimas, que é o que importa

Com a janela anônima, adicione dois produtos e volte para a home. O mini carrinho do topo precisa mostrar dois itens. Depois abra uma **segunda** janela anônima separada, entre na loja sem adicionar nada e confirme que o mini carrinho mostra zero. Se a segunda janela mostrar os dois produtos da primeira, pare tudo, desligue o cache e revise as exclusões: há vazamento de conteúdo entre visitantes, que é o pior defeito possível numa loja.

| Página | Cabeçalho esperado na 2ª visita | Mini carrinho |
|---|---|---||
| Home | hit | Só reflete o carrinho com ESI ou AJAX ativo (ver a seção do mini carrinho) |
| Categoria | hit | Só reflete o carrinho com ESI ou AJAX ativo |
| Produto | hit | Só reflete o carrinho com ESI ou AJAX ativo |
| Carrinho | sem hit | Itens reais |
| Finalizar compra | sem hit | Itens reais |
| Minha conta e endpoints | sem hit | Dados do titular |

## Quando algo sai errado

**Categoria sempre em miss.** Verifique se algum plugin está criando cookie em toda visita (chat, popup, teste A/B). Teste desativando um por vez, sempre com a aba Rede aberta na janela anônima.

**Cupom aplicado não aparece em outra página.** Confirme que o carrinho está na lista de exclusões com o slug real, e não com o slug em inglês presumido.

**Pedido confirmado mostra dados de outro pedido.** Exclua explicitamente o endpoint de recebimento de pedido. Esse é o caso em que a exclusão genérica do checkout às vezes não cobre a URL com o número do pedido.

**Cliente diz que vê a loja logada como outra pessoa.** Desligue o cache imediatamente (`LiteSpeed Cache > Cache > Ativar Cache = OFF`), purgue tudo, e só volte a ligar depois de revisar exclusões e cookies de login. Perda de alguns milissegundos é reversível; sessão trocada entre clientes não é.

**Depois de trocar de tema ou de plugin de carrinho.** Repita o teste das duas janelas anônimas. Temas mudam a forma de renderizar o mini carrinho e o que funcionava pode parar de funcionar sem nenhum aviso no painel.

## O que este guia não promete

Não há aqui nenhuma medição de tempo de resposta feita por nós, nem estimativa de ganho de conversão. Cache de página reduz trabalho do PHP e do banco nas páginas que são idênticas para todos os visitantes, e isso é verificável na sua própria loja com a aba Rede e com o relógio do navegador. Quanto isso vale em venda depende do seu tráfego, do seu tema e do que mais está pesando na página (imagem grande, script de terceiro, consulta lenta).

Duas recomendações contra o hábito comum:

- Se sua loja tem tráfego muito baixo e as páginas de categoria raramente são visitadas duas vezes dentro do tempo de vida do cache, o ganho será pequeno. O cache vale mais quando a mesma página é pedida várias vezes.
- Se a loja está lenta mesmo em página simples e cacheada, o problema não é cache: é consulta ao banco, plugin pesado ou imagem sem otimização. Olhe isso antes de mexer em plano ou servidor.

O que a [documentação oficial do LSCache for WordPress sobre compatibilidade com plugins de terceiros](https://docs.litespeedtech.com/lscache/lscwp/thirdparty/) sustenta é um ponto só: o WooCommerce consta como suportado pelo plugin. O campo Não armazenar URIs em cache, a aba ESI e o bloco LiteSpeed no widget são telas do plugin, descritas aqui como aparecem na instalação, e não vêm dessa página. Os slugs usados nos exemplos são de uma instalação em português e precisam ser conferidos em `WooCommerce > Configurações > Avançado` na sua loja antes de serem copiados.

