🎉 USE O CUPOM DESCONTO.FULL | 20% OFF acima de R$ 50,00

Como corrigir o conflito de cache entre WP Rocket, LiteSpeed e Perfmatters

Time Full Services Time Full Services
Tipo Performance & Velocidade
Nome do erro Conflito de cache entre WP Rocket, LiteSpeed e Perfmatters EN: WP Rocket, LiteSpeed and Perfmatters cache conflict
Severidade Grave
Descrição O conflito acontece quando WP Rocket e o plugin LiteSpeed Cache geram cache de página ao mesmo tempo e o Perfmatters repete otimizacoes (como Remove Unused CSS) que o WP Rocket já faz. O resultado e layout quebrado, JavaScript que para de funcionar e o ganho de PageSpeed que some.

O que é o conflito de cache entre WP Rocket, LiteSpeed e Perfmatters?

O conflito de cache entre WP Rocket, LiteSpeed e Perfmatters ocorre porque WP Rocket e o plugin LiteSpeed Cache são, os dois, plugins de cache de página completa. A documentação oficial do WP Rocket lista o LiteSpeed Cache como incompativel: rodar dois plugins de cache de página ao mesmo tempo faz um sobrescrever o HTML do outro e gera resultados imprevisiveis. O Perfmatters e diferente: ele não faz cache de página, e um plugin de otimização. O problema com ele e duplicar a mesma otimização (minificar, adiar JavaScript, remover CSS não usado) que o WP Rocket já aplica, processando o mesmo arquivo duas vezes.

Como identificar

  • Aviso do próprio WP Rocket no painel: ‘The following plugins are not compatible with this plugin and may cause unexpected results’, com botão para desativar o plugin conflitante
  • Layout quebrado ou sem estilo no frontend depois de ativar Remove Unused CSS nos dois plugins (WP Rocket e Perfmatters)
  • Funções em JavaScript param de responder (menu, slider, formulário) quando WP Rocket e Perfmatters adiam ou atrasam o mesmo script
  • A nota do PageSpeed Insights não melhora ou até cai, mesmo com os dois plugins de otimização ativos
  • Páginas servindo HTML desatualizado: ao limpar o cache de um plugin, o outro continua entregando a versão antiga em cache
Antes de começar: Faca um backup completo do site (arquivos e banco) antes de desativar plugins de cache e apagar pastas de cache pelo terminal. O comando rm -rf remove arquivos de forma permanente, e desativar o cache de página em horario de pico aumenta a carga no servidor.

Como prevenir

  • Use apenas um plugin de cache de página por site: ou WP Rocket, ou o plugin LiteSpeed Cache, nunca os dois ao mesmo tempo
  • Antes de ligar uma otimização no Perfmatters (minificar, remover CSS, adiar JS), confirme que a mesma opção esta desligada no WP Rocket
  • Sempre que mudar uma configuração de cache ou otimização, limpe o cache e teste em janela anonima antes de considerar resolvido
  • Documente qual plugin e responsável por cada otimização para a equipe não reativar a opção duplicada por engano

Causa

  • WP Rocket e o plugin LiteSpeed Cache ativos juntos: os dois são cache de página completa e a doc oficial do WP Rocket marca o LiteSpeed Cache como incompativel, porque um sobrescreve o HTML em cache do outro.
  • A opção Remove Unused CSS ligada ao mesmo tempo no WP Rocket (Otimizar arquivos CSS) e no Perfmatters (CSS -> Remove Unused CSS): o mesmo CSS crítico e calculado duas vezes e remove regras que a página precisa, quebrando o layout.
  • Defer JavaScript do WP Rocket e Defer/Delay JavaScript do Perfmatters atuando sobre os mesmos arquivos: o script recebe o atributo defer em dobro e perde a ordem de carregamento que algumas bibliotecas exigem.
  • Minificacao de CSS e JavaScript ativada nos dois plugins ao mesmo tempo, concatenando um arquivo já minificado e gerando código invalido.
  • Hospedagem em servidor LiteSpeed com o LSCache habilitado no nível do servidor (.htaccess) ALÉM do plugin LiteSpeed Cache, criando uma terceira camada de cache sobre o WP Rocket.

Como resolver

  1. Escolha um único plugin de cache de página e desative o outro: WP Rocket e o plugin LiteSpeed Cache não podem coexistir. Escolha um deles como o cache de página e desative completamente o outro em Plugins. Se você vai ficar com o WP Rocket, desative o plugin LiteSpeed Cache.
    Painel: Plugins -> Plugins Instalados -> LiteSpeed Cache -> Desativar
    wp plugin deactivate litespeed-cache
  2. Limpe o cache antigo que o plugin desativado deixou para tras: Desativar o plugin não apaga os arquivos já gerados. Limpe a pasta de cache do LiteSpeed e o cache do WP Rocket para o site parar de servir HTML em cache antigo.
    rm -rf wp-content/litespeed/
    wp rocket clean --confirm
    Painel: WP Rocket -> Dashboard -> Limpar cache
  3. Se a hospedagem usa servidor LiteSpeed, mantenha so o LSCache do servidor: Em servidor LiteSpeed, o cache pode estar ativo no nível do servidor mesmo sem o plugin. O WP Rocket limpa esse cache automaticamente quando o cache dele e limpo, entao o plugin LiteSpeed Cache não e necessário. Confirme que a regra do LSCache esta no .htaccess e deixe o plugin desativado.
    grep -i litespeed_cache .htaccess
  4. Tire as otimizacoes duplicadas do Perfmatters: O Perfmatters pode continuar ativo com WP Rocket, mas cada otimização tem de ficar em um plugin so. Como a doc do WP Rocket avisa que o Remove Unused CSS dele e incompativel com o do Perfmatters, deixe Remove Unused CSS, minificacao e defer/delay de JavaScript ligados em apenas um dos dois.
    Painel: Perfmatters -> Assets -> CSS -> Remove Unused CSS = Off
    Painel: Perfmatters -> Assets -> JavaScript -> Defer JavaScript = Off
    Painel: WP Rocket -> Otimizar arquivos CSS -> Remover CSS não utilizado = On
  5. Limpe o cache e revalide layout, JavaScript e PageSpeed: Depois de centralizar cache e otimizacoes, limpe tudo de novo e teste em janela anonima. Confira se o layout voltou, se os scripts respondem e rode o PageSpeed para confirmar o ganho.
    Painel: WP Rocket -> Dashboard -> Limpar cache
    https://pagespeed.web.dev/
BASH
# Auditar plugins de cache/otimizacao ativos (WP-CLI)
wp plugin list --status=active --field=name | grep -Ei 'rocket|litespeed|perfmatters|w3-total|wp-super|fastest|optimize'

# Manter SO o WP Rocket como cache de pagina: desativar o plugin LiteSpeed Cache
wp plugin deactivate litespeed-cache

# Limpar o cache antigo deixado para tras e o cache do WP Rocket
rm -rf wp-content/litespeed/
wp rocket clean --confirm

Perguntas frequentes

Posso usar WP Rocket e LiteSpeed Cache ao mesmo tempo?
Não. A documentação oficial do WP Rocket lista o plugin LiteSpeed Cache como incompativel, porque os dois fazem cache de página completa e acabam sobrescrevendo o HTML um do outro. Escolha um e desative o outro.
WP Rocket e Perfmatters podem ficar ativos juntos?
Sim. O Perfmatters não faz cache de página, e um plugin de otimização, entao convive com o WP Rocket. O cuidado e não ligar a mesma otimização (Remove Unused CSS, minificar, defer JS) nos dois ao mesmo tempo.
Estou em servidor LiteSpeed. Preciso do plugin LiteSpeed Cache com o WP Rocket?
Não. Em servidor LiteSpeed, o WP Rocket limpa o cache do servidor (LSCache) automaticamente quando o cache dele e limpo. Você pode manter o cache no nível do servidor e deixar o plugin LiteSpeed Cache desativado.
Por que meu layout quebrou depois de ligar o Remove Unused CSS?
Porque o WP Rocket e o Perfmatters calcularam o CSS crítico em paralelo e removeram regras que a página ainda usava. Deixe o Remove Unused CSS ligado em apenas um dos dois plugins e limpe o cache.
Qual plugin devo manter para minificar e adiar JavaScript?
Tanto faz tecnicamente, desde que seja so um. Escolha o WP Rocket ou o Perfmatters para minificar e adiar o JavaScript e desligue essas mesmas opções no outro, para o arquivo não ser processado duas vezes.
Desativei o plugin de cache mas o site continua mostrando a versão antiga. Por que?
Desativar o plugin não apaga os arquivos já gerados. Limpe a pasta de cache que ficou (por exemplo wp-content/litespeed) e o cache do WP Rocket, depois teste em janela anonima para ver a versão nova.
Meu PageSpeed não melhorou mesmo com os dois plugins de otimização. O que fazer?
Otimizacoes duplicadas costumam se anular ou gerar código invalido, derrubando a nota. Centralize cada otimização em um plugin so, limpe o cache e rode o PageSpeed de novo para medir o ganho real.

Seja PRO.

Tenha acesso a snippets de código premium — PHP, JavaScript, CSS e HTML prontos para usar em seus projetos.

Conhecer o plano Pro →

Uma nova era para o WordPress.

A FULL Services redefine o CMS com uma arquitetura modular que transforma o WordPress em um motor de crescimento digital. 

Painéis personalizados

Um novo nível de controle para o WordPress. Acompanhe métricas, automações e evolução do seu site em um único painel visual.

A força por trás de grandes marcas

Para agências, estúdios e profissionais independentes que desejam oferecer soluções de alto nível com sua própria marca.

Componentes

Hero Sections

30 componentes

Seções de CTA

14 componentes

Login

14 componentes

Blog

14 componentes

Cabeçalhos

24 componentes

Seções de FAQ

53 componentes

Cadastro

53 componentes

Blog individual

53 componentes

Rodapés

28 componentes

Seções de contato

27 componentes

Seções de preços

27 componentes

Faixas

27 componentes

Portfólio

16 componentes

Seções de equipe

12 componentes

Números

12 componentes

Logotipos

12 componentes