Cache não limpa no WordPress: como forçar a limpeza

Tipo Performance & Velocidade

Nome do erro Cache não limpa EN: Cache not clearing

Severidade Atenção

Descrição Cache que não limpa no WordPress é quando o site continua exibindo a versão antiga de uma página depois de você editá-la, porque alguma camada de cache não foi invalidada. Costuma vir de várias camadas empilhadas (plugin, servidor, CDN e navegador) em que purgar só uma delas deixa as outras servindo o conteúdo velho.

O que é o cache que não limpa no WordPress?

O cache que não limpa no WordPress acontece quando uma cópia salva da página continua sendo servida mesmo após uma alteração. O WordPress raramente tem só uma camada de cache: existe o cache do plugin de performance, o cache do próprio servidor (como Varnish ou LiteSpeed), o cache na borda do CDN e o cache do navegador do visitante. Cada camada guarda sua própria cópia, e limpar apenas uma faz as demais seguirem entregando a versão antiga. Resolver o problema é entender quais camadas estão ativas e purgar todas, na ordem certa, do servidor até o navegador.

Como identificar

Você edita um post e a alteração não aparece no site, mas surge numa janela anônima.
O cabeçalho de resposta mostra “x-cache: HIT” ou “cf-cache-status: HIT” mesmo após limpar o plugin.
Mudanças de CSS aparecem para você, mas visitantes continuam vendo o layout antigo.
O conteúdo só atualiza depois de forçar um recarregamento sem cache no navegador (Ctrl+F5).

Como prevenir

Use apenas um plugin de cache por vez para evitar conflito entre camadas
Configure o plugin para purgar o CDN e o cache de servidor automaticamente ao salvar conteúdo
Mantenha tempos de expiração de navegador moderados em arquivos que mudam (HTML), reservando os longos só para estáticos versionados

Causa

Várias camadas de cache empilhadas (plugin, servidor, CDN, navegador) em que purgar só uma deixa as outras servindo o conteúdo antigo.
Cache de borda do CDN (como Cloudflare) que mantém a página por horas e não é purgado junto com o cache do plugin.
Cache no nível do servidor (Varnish, LiteSpeed, NGINX FastCGI) que o plugin de cache do WordPress não consegue invalidar sozinho.
Cabeçalhos de expiração longos no navegador, fazendo o visitante reaproveitar a cópia local por dias.
Dois plugins de cache ativos ao mesmo tempo, um recriando a cópia que o outro acabou de apagar.

Como resolver

Mapeie as camadas de cache ativas: verifique nos cabeçalhos de resposta quais caches existem (plugin, servidor, CDN). Saber quantas camadas há evita limpar uma e achar que resolveu.
Purgue o cache do plugin: no seu plugin de performance, use "Limpar todo o cache". Esse é o primeiro nível e regenera o HTML estático do WordPress.
Limpe o cache do servidor e do CDN: purgue o cache de borda no painel do CDN (ex.: Cloudflare) e o cache de servidor (Varnish/LiteSpeed) pelo painel da hospedagem. Sem isso, a borda continua servindo a versão antiga.
Force a renovação no navegador: teste com recarregamento sem cache (Ctrl+F5) e numa janela anônima. Se atualizar só assim, o problema é o cabeçalho de expiração do navegador, não o servidor.
Remova plugins de cache duplicados: deixe apenas um plugin de cache ativo. Dois ao mesmo tempo brigam pelo controle e um recria o que o outro apaga, deixando o cache eternamente desatualizado.
Confirme com uma alteração de teste: edite um texto visível, salve e confira no site sem cache. Se aparecer de imediato em todas as camadas, a limpeza está completa.

PHP

// functions.php do tema-filho: botao na barra de admin que purga todas as camadas
add_action( 'admin_bar_menu', function ( $bar ) {
  $bar->add_node( array(
    'id'    => 'full-purge-tudo',
    'title' => 'Limpar TODO o cache',
    'href'  => wp_nonce_url( admin_url( '?full_purge=1' ), 'full_purge' ),
  ) );
}, 100 );

add_action( 'admin_init', function () {
  if ( empty( $_GET['full_purge'] ) || ! current_user_can( 'manage_options' ) ) {
    return;
  }
  check_admin_referer( 'full_purge' );

  wp_cache_flush();                                   // cache de objeto (Redis/Memcached)
  if ( function_exists( 'rocket_clean_domain' ) ) {   // plugin de cache de pagina
    rocket_clean_domain();
  }
  if ( function_exists( 'w3tc_flush_all' ) ) {
    w3tc_flush_all();
  }
  do_action( 'litespeed_purge_all' );                 // cache de servidor LiteSpeed

  wp_safe_redirect( remove_query_arg( array( 'full_purge', '_wpnonce' ) ) );
  exit;
} );

Perguntas frequentes

Por que o site mostra a versão antiga mesmo depois de limpar o cache?

Porque o WordPress costuma ter várias camadas de cache: plugin, servidor, CDN e navegador. Limpar só uma delas deixa as outras servindo a cópia antiga. É preciso purgar todas, do servidor e do CDN até forçar a renovação no navegador.

Como sei quantas camadas de cache meu site tem?

Inspecione os cabeçalhos de resposta da página na aba Network do navegador. Linhas como "x-cache", "cf-cache-status", "x-litespeed-cache" ou "age" indicam cache de servidor ou de CDN além do plugin do WordPress.

O cache do Cloudflare conta como camada separada?

Sim. O Cloudflare guarda a página na borda e não é limpo quando você purga só o plugin de cache do WordPress. Você precisa purgar o cache no painel do Cloudflare ou configurar o plugin para fazer isso automaticamente ao salvar.

Por que a alteração aparece para mim mas não para os visitantes?

Em geral porque o seu navegador já recarregou sem cache ou você está logado e recebe a versão não cacheada, enquanto o visitante anônimo recebe a cópia salva no CDN ou no servidor. Purgar essas camadas resolve para todos.

Posso usar dois plugins de cache ao mesmo tempo?

Não é recomendado. Dois plugins de cache disputam o controle e um recria a cópia que o outro acabou de apagar, deixando o cache permanentemente desatualizado e difícil de purgar. Mantenha apenas um ativo.

Limpar o cache com frequência prejudica a performance?

Limpar tudo a cada pequena edição força o servidor a regenerar as páginas e eleva o TTFB temporariamente até o cache reaquecer. O ideal é purgar de forma seletiva, só as URLs alteradas, e reservar a limpeza total para mudanças amplas de tema ou CSS.

Atenção

Como corrigir o erro de carregamento de fontes no WordPress

O font loading lento no WordPress acontece quando as fontes web (woff2, woff ou ttf) demoram a baixar e o navegador segura o texto até a fonte chegar. O resultado e texto invisivel por um instante (FOIT) ou uma troca visivel de fonte (FOUT), o que atrasa a primeira pintura e eleva o LCP da página.

Crítico

Como corrigir scripts essenciais do WooCommerce removidos pelo Perfmatters

Scripts do WooCommerce removidos pelo Perfmatters acontecem quando o Script Manager desativa assets como wc-cart-fragments, woocommerce e wc-checkout marcados como Everywhere, em vez de Current URL. Sem esses arquivos, o carrinho Ajax para de atualizar e o checkout fica sem o JavaScript que processa o pedido.

Atenção

Como corrigir a lentidão do Astra Pro com muitas fontes personalizadas no WordPress

A queda de performance do Astra Pro com muitas fontes personalizadas ocorre quando o tema carrega várias famílias e pesos de Google Fonts de servidores externos, somando requisições que bloqueiam a renderização e atrasam o LCP da página.

Atenção

Como corrigir o erro de minificação de CSS no WP-Optimize

O erro de minify CSS no WP-Optimize aparece quando a opção de minificar e mesclar folhas de estilo processa um CSS incompativel ou com erro de sintaxe, deixando o site sem estilo, com layout quebrado ou com elementos desalinhados. A correção e isolar o CSS culpado, exclui-lo do processamento e resetar os arquivos minificados.

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.

Informativo

Como corrigir o aviso de formatos de imagem (WebP/AVIF) no WordPress

Servir cada imagem WebP no WordPress significa entregar versões WebP ou AVIF ao navegador no lugar de JPEG e PNG. O aviso aparece quando o site não gera nem entrega esses formatos, porque o nucleo do WordPress aceita upload de WebP mas não converte as imagens JPEG e PNG já existentes nem decide a entrega por navegador.

Setores

Extensões

Integrações

Como resolver cache que não limpa no WordPress

O que é o cache que não limpa no WordPress?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o erro de carregamento de fontes no WordPress

Como corrigir scripts essenciais do WooCommerce removidos pelo Perfmatters

Como corrigir a lentidão do Astra Pro com muitas fontes personalizadas no WordPress

Como corrigir o erro de minificação de CSS no WP-Optimize

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

Como corrigir o aviso de formatos de imagem (WebP/AVIF) no WordPress

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