# Como corrigir o cache que não funciona no WP-Optimize

O cache do WP-Optimize não funciona quando o plugin não consegue gravar a página estática na pasta wp-content/wpo-cache, geralmente por cache desativado, permissão de escrita negada ou conflito com outro plugin de cache ativo.

## O que é cache do WP-Optimize que não funciona?

O cache do WP-Optimize que não funciona é a situação em que a função Page Cache está marcada como ativa no painel, mas o plugin não entrega a versão estática (HTML salvo em disco) ao visitante. Em vez do arquivo pré-gerado, cada acesso continua processando PHP e consultando o banco, então o ganho de velocidade simplesmente não acontece. O WP-Optimize salva cada página em um arquivo dentro da pasta wpo-cache e adiciona um comentário no rodapé do HTML quando a entrega vem do cache. Quando esse arquivo não é criado, ou existe mas não é servido, o site responde como se não houvesse cache nenhum.

## Como identificar

- O rodapé do código-fonte da página, visto deslogado, não traz o comentário Cached by WP-Optimize que o plugin injeta quando entrega a versão estática
- A pasta wpo-cache dentro de wp-content está vazia ou nem existe, mesmo depois de visitar várias páginas deslogado
- Ao salvar as configurações de cache aparece um aviso sobre proprietário do arquivo (file owner) junto de um formulário pedindo dados de FTP
- O tempo de resposta (TTFB) medido no PageSpeed ou GTmetrix continua alto e idêntico ao de antes de ativar o cache
- A página de Cache no painel mostra o cache ativado, porém o contador de páginas em cache permanece em zero

**Antes de começar:** Antes de editar o wp-config.php ou apagar o advanced-cache.php, baixe uma cópia de cada arquivo. Um erro de digitação no wp-config derruba o site inteiro com tela em branco.

## Como prevenir

- Mantenha apenas um plugin de cache de página ativo por vez; ao trocar de plugin, desative e limpe o anterior antes de ativar o novo
- Após qualquer migração de servidor ou restauração de backup, confira o dono e a permissão da pasta wp-content para o cache continuar conseguindo gravar
- Valide o cache sempre deslogado e com a minificação de HTML desligada, procurando o comentário Cached by WP-Optimize no rodapé
- Deixe a constante FS_METHOD como direct no wp-config quando o host usa o mesmo usuário para PHP e arquivos, evitando o formulário de FTP em futuras ativações

Erros relacionados

- [Como corrigir o conflito de cache entre WP-Optimize e WP Rocket](https://full.services/wp-fixer/corrigir-conflito-cache-wp-optimize-wp-rocket/)
- [Como corrigir o cache mobile que não é gerado no WP-Optimize](https://full.services/wp-fixer/corrigir-cache-mobile-wp-optimize/)
- [Como corrigir o cache do WP-Optimize que quebra o editor do Elementor](https://full.services/wp-fixer/corrigir-cache-wp-optimize-quebra-elementor/)

## Causa

- A opção Enable page caching, na aba WP-Optimize -> Cache -> Page cache, nunca foi marcada e salva; o cache fica desativado por padrão na instalação.
- O usuário do servidor web (www-data) não é o dono da pasta wp-content, então o PHP não consegue criar a wpo-cache e o WP-Optimize cai no formulário de FTP em vez de gravar o arquivo.
- Outro plugin de cache de página (WP Super Cache, W3 Total Cache, LiteSpeed ou WP Rocket) está ativo ao mesmo tempo, e só o último page cache ativado funciona, anulando o do WP-Optimize.
- O teste foi feito com usuário logado no WordPress; por padrão o WP-Optimize não serve a versão em cache para quem está logado, o que faz parecer que o cache não roda.
- A minificação de HTML do próprio WP-Optimize está removendo o comentário Cached by WP-Optimize do rodapé, escondendo que a página de fato está em cache.
- A constante WP_CACHE está ausente ou definida como false no wp-config.php, ou o arquivo advanced-cache.php está corrompido por uma ativação anterior de outro plugin de cache.

## Como resolver

1. Confirme que o Page Cache está realmente ligado: No painel do WordPress, abra a tela de cache do plugin, marque a opção de cache de página e salve. O cache é desativado por padrão, então sem este passo nenhum arquivo é gerado. O caminho de menu é WP-Optimize -> Cache -> Page cache, e a opção a marcar é Enable page caching.

```
WP-Optimize -> Cache -> Page cache -> Enable page caching
```

2. Teste sempre deslogado e com a minificação desativada: Saia da sua conta do WordPress (ou use uma janela anônima), limpe o cache do navegador e desative temporariamente a minificação de HTML do plugin. Recarregue a página e procure o comentário de cache no fim do código-fonte. Logado, o WP-Optimize não entrega cache, e a minificação apaga o comentário de verificação.

```
Comentario esperado no rodape do HTML: Cached by WP-Optimize
WP-Optimize -> Minify -> desligar Minify HTML durante o teste
```

3. Desative qualquer outro plugin de cache de página: Em Plugins, deixe apenas um cache de página ativo. Quando dois cuidam da mesma camada, só o último ativado funciona, então mantenha o WP-Optimize e desative os concorrentes. Depois limpe o cache do WP-Optimize para forçar a regeração.

```
Plugins -> desativar WP Super Cache, W3 Total Cache, LiteSpeed Cache ou WP Rocket
WP-Optimize -> Cache -> Purge cache
```

4. Verifique a pasta de cache e a permissão de escrita: Via FTP ou gerenciador de arquivos, confirme se a pasta wpo-cache existe e está sendo populada após acessos deslogados. Se o WP-Optimize mostrou o formulário de FTP ou um aviso de proprietário do arquivo, o servidor está bloqueando a escrita. Ajuste o dono da pasta para o usuário do servidor web ou aplique a permissão adequada.

```
wp-content/wpo-cache/
chown -R www-data:www-data wp-content/wpo-cache
chmod -R 755 wp-content/wpo-cache
```

5. Force a escrita direta com a constante FS_METHOD: Se mesmo com a permissão correta o WP-Optimize continua pedindo FTP, instrua o WordPress a gravar arquivos diretamente. Adicione a constante no wp-config.php, acima da linha que pede para parar de editar, e reative o cache. O bloco de código abaixo traz a linha exata.

```
Adicionar no wp-config.php, antes de: That's all, stop editing
```

6. Recupere o advanced-cache.php se o cache foi quebrado por outro plugin: Quando uma instalação anterior de outro plugin de cache deixou lixo, o arquivo de bootstrap do cache fica inválido. Apague a linha de WP_CACHE do wp-config, remova o arquivo de drop-in e reative o cache do WP-Optimize, que recria os dois corretamente.

```
Remover do wp-config.php a linha: define( 'WP_CACHE', true );
Apagar o arquivo: wp-content/advanced-cache.php
WP-Optimize -> Cache -> reativar Page cache para recriar o drop-in
```


## Código

```php
/* Força o WordPress a gravar arquivos direto, sem pedir FTP */
define( 'FS_METHOD', 'direct' );
```

## Perguntas frequentes

### Como sei se o cache do WP-Optimize está realmente funcionando?

Saia da sua conta, abra a página em uma janela anônima e veja o código-fonte. No final do HTML deve aparecer o comentário Cached by WP-Optimize. Como alternativa, confira se a pasta wp-content/wpo-cache está sendo preenchida com arquivos após os acessos.

### Por que a pasta wpo-cache está vazia?

Quase sempre é permissão de escrita: o usuário do servidor web não consegue criar arquivos em wp-content. O WP-Optimize sinaliza isso com um aviso de proprietário do arquivo e um formulário de FTP. Ajuste o dono e a permissão da pasta, ou defina FS_METHOD como direct no wp-config.php.

### Posso usar o WP-Optimize junto com o WP Rocket ou o LiteSpeed Cache?

Não para o cache de página. Apenas um cache de página funciona por vez, e o último ativado vence. Escolha um único plugin como cache de página e desative o cache dos demais para evitar o conflito que faz o WP-Optimize parecer parado.

### O cache não aparece quando estou logado, isso é erro?

Não. Por padrão o WP-Optimize não serve a versão em cache para usuários logados, porque quem está logado costuma precisar de conteúdo ao vivo. Sempre teste o cache deslogado ou em uma janela anônima do navegador.

### Ativei o cache mas o site continua lento, o que verifico primeiro?

Confirme na tela de cache do plugin se a opção de cache de página está marcada e salva, já que ela vem desativada de fábrica. Depois teste deslogado e cheque se a pasta wpo-cache está recebendo arquivos. Se estiver vazia, o problema é permissão de escrita.

### A minificação atrapalha a verificação do cache?

Pode atrapalhar. A minificação de HTML remove o comentário Cached by WP-Optimize do rodapé, então a página fica em cache mas parece que não está. Desligue a minificação durante o teste e confirme pela pasta wpo-cache.

### Apareceu um erro no advanced-cache.php, como resolvo?

Esse arquivo é o drop-in que liga o cache e costuma quebrar quando dois plugins de cache foram ativados. Remova a linha de WP_CACHE do wp-config.php, apague o arquivo wp-content/advanced-cache.php e reative o cache do WP-Optimize, que recria os dois de forma limpa.

**Fonte:** [WP-Optimize — Como sei se minha página está em cache](https://teamupdraft.com/documentation/wp-optimize/topics/caching/faqs/how-do-i-know-my-webpage-is-being-cached/)