Cache WP-Optimize não funciona: como corrigir

Tipo Performance & Velocidade

Nome do erro Cache não funciona no WP-Optimize EN: WP-Optimize cache not working

Severidade Grave

Descrição 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

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

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

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.

Atenção

Como corrigir o erro de Heartbeat API entre Perfmatters e WP Rocket no WordPress

O erro de Heartbeat com Perfmatters e WP Rocket acontece quando os dois plugins controlam a Heartbeat API do WordPress ao mesmo tempo: o ajuste mais restritivo prevalece, derrubando autosave, bloqueio de edição e a previa do page builder.

Atenção

Como corrigir o cache mobile que não é gerado no WP-Optimize

O cache mobile do WP-Optimize não é gerado quando a opção Generate separate files for mobile devices está desligada, quando o site não usa tema ou plugin de detecção mobile, ou quando o cache desktop já foi salvo antes do primeiro acesso mobile e passa a ser servido a todos os dispositivos.

Grave

Como corrigir o erro de JavaScript ao combinar arquivos no WP Rocket

A opção Combine JavaScript Files do WP Rocket junta todos os scripts em um único arquivo; quando dois scripts dependem de ordem ou de uma variavel global, a juncao gera erro de JavaScript e quebra menu, carrossel, slider ou formulário. A correção e excluir o arquivo conflitante do combine.

Grave

Como corrigir o conflito de CSS otimizado entre Astra Pro e WP Rocket

O conflito de CSS otimizado entre Astra Pro e WP Rocket acontece quando o Remove Unused CSS ou a combinacao de CSS do WP Rocket descarta o estilo dinâmico do Astra, e o site carrega sem layout: fontes erradas, cores fora do lugar e botões sem formatacao. Aparece so na primeira visita de cada URL, porque o CSS usado e gerado por página.

Informativo

Como corrigir o lazy load de vídeos do YouTube no WP Rocket

O lazy load de vídeos do YouTube no WP Rocket adia o carregamento dos iframes e troca o embed por uma miniatura; ele falha quando o tema usa CSS de proporção no container, quando o plugin Complianz bloqueia o iframe ou quando o vídeo está num bloco que o WP Rocket não processa.

Atenção

Como corrigir o erro de Lazy Load no Perfmatters

O lazy load do Perfmatters falha quando as imagens travam num placeholder, quebram ou não carregam até o usuário rolar. As causas mais comuns são o script lazyload.min.js ser adiado por outro plugin, dois lazy loaders ativos ao mesmo tempo ou imagens acima da dobra não excluidas.

Setores

Extensões

Integrações

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

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

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o erro de Heartbeat API entre Perfmatters e WP Rocket no WordPress

Como corrigir o cache mobile que não é gerado no WP-Optimize

Como corrigir o erro de JavaScript ao combinar arquivos no WP Rocket

Como corrigir o conflito de CSS otimizado entre Astra Pro e WP Rocket

Como corrigir o lazy load de vídeos do YouTube no WP Rocket

Como corrigir o erro de Lazy Load no Perfmatters

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos