WP Rocket erro 404: como corrigir URLs e assets

Tipo Performance & Velocidade

Nome do erro Erro 404 após ativar WP Rocket EN: 404 error after enabling WP Rocket

Severidade Grave

Descrição O WP Rocket erro 404 surge quando o navegador pede um arquivo CSS/JS minificado, um asset de CDN ou uma página que o cache aponta para um caminho inexistente. Na maioria dos casos a causa é o nome do arquivo combinado mudar e a referência antiga ficar em cache.

O que é erro 404 do WP Rocket?

O WP Rocket erro 404 é a resposta Não Encontrado que o servidor devolve quando uma URL referenciada pela página não existe mais no disco. Ao ativar o WP Rocket, ele passa a combinar e minificar arquivos CSS e JavaScript dentro de wp-content/cache/min e a reescrever caminhos de assets para a CDN, então qualquer referência antiga que continue em cache, em HTML preloadado ou no snapshot de um buscador aponta para um arquivo que foi regenerado com outro nome. O resultado é um 404 no asset (folha de estilo ou script some) ou, quando há conflito com permalinks e regras de reescrita, um 404 na página inteira.

Como identificar

O console do navegador (aba Network) mostra status 404 (Not Found) para arquivos como /wp-content/cache/min/1/xxxx.css ou .js
O site carrega sem estilos ou com layout quebrado porque a folha de estilo combinada retornou 404
Mensagem 404 Not Found ou Página não encontrada em URLs que funcionavam antes de ativar o WP Rocket
Imagens, fontes ou scripts servidos pela CDN retornam 404 e o domínio no caminho do asset está diferente do domínio do site
O erro aparece logo após salvar uma alteração na aba Otimização de Arquivos ou após uma atualização de tema/plugin

Antes de começar: Antes de editar o .htaccess ou a configuração do Nginx, baixe uma cópia do arquivo original. Um erro de sintaxe nessas regras derruba o site inteiro com erro 500, e ter o backup permite restaurar em segundos.

Como prevenir

Deixe Minificar JavaScript ligado e Combinar JavaScript desligado em sites que recebem atualizações frequentes de tema e plugins, para o nome do arquivo não mudar a cada deploy.
Defina uma versão canônica de domínio (com ou sem www) com redirecionamento 301 e use o mesmo formato no painel, na CDN e nos permalinks.
Sempre que ativar ou testar uma CDN, abra um arquivo de wp-content/cache/min direto pela URL da CDN para confirmar que a zona serve o asset antes de jogar tráfego real.
Mantenha os permalinks em Nome do post e, em Nginx, documente a regra de reescrita no server block junto do deploy para ela não se perder em migrações.

Causa

A opção Combinar arquivos JavaScript (Combine JavaScript files) está ligada: o WP Rocket gera um nome de arquivo novo a cada mudança e o HTML em cache, o preload ou o snapshot do Google ainda apontam para o nome antigo, que não existe mais.
O domínio em Configurações -> Geral está em www e os assets em cache foram gerados para a versão sem www (ou o contrário), então o caminho do arquivo minificado resolve para um host que não serve aquele arquivo.
O CNAME da CDN em Content Delivery -> Other CDN está incorreto ou aponta para uma zona que não tem os arquivos de wp-content/cache/min, e cada asset reescrito para a CDN volta como 404.
Os permalinks estão na opção Padrão (Plain) em Configurações -> Links Permanentes: as regras de reescrita que o WP Rocket grava no .htaccess dependem de URLs amigáveis, e sem elas o servidor devolve 404 na página.
O site roda em Nginx, onde o WP Rocket não consegue aplicar as regras do .htaccess, e a configuração de reescrita do servidor não foi adicionada manualmente, deixando páginas em cache retornando 404.

Como resolver

Limpe o cache e confirme onde o 404 acontece: Antes de mexer em opções, force a regeneração dos arquivos. No menu superior do WordPress clique em WP Rocket e depois em Limpar e pré-carregar o cache, recarregue a página com cache desativado e veja na aba Network do navegador qual recurso retorna 404 (asset minificado, asset de CDN ou a própria página). Isso define qual passo abaixo aplicar.
```
Painel -> menu superior WP Rocket -> Limpar e pré-carregar o cache
DevTools (F12) -> aba Network -> recarregar -> filtrar por status 404
```
Desligue Combinar JavaScript e mantenha só Minificar: Se o 404 é em arquivos de wp-content/cache/min, a combinação é a causa mais comum porque renomeia o arquivo. Em WP Rocket -> Otimização de Arquivos, desmarque Combinar arquivos JavaScript e deixe ligada apenas Minificar arquivos JavaScript, que não altera o nome do arquivo. Salve e limpe o cache de novo.
```
WP Rocket -> Otimização de Arquivos -> CSS/JavaScript
Desmarcar: Combinar arquivos JavaScript (Combine JavaScript files)
Manter marcado: Minificar arquivos JavaScript (Minify JavaScript files)
```
Padronize www/não-www e verifique a CDN: Garanta que o Endereço do site em Configurações -> Geral usa exatamente o mesmo formato (com ou sem www) que o resto do site e que existe um redirecionamento 301 forçando essa versão. Se você usa CDN, confira o CNAME em WP Rocket -> CDN (Content Delivery) e teste abrir um arquivo de cache direto pela URL da CDN; se ele abrir 404, a zona não tem os arquivos minificados e o CNAME precisa ser corrigido com o provedor.
```
Configurações -> Geral -> Endereço do WordPress / Endereço do site
WP Rocket -> CDN -> CNAME(s) (Content Delivery -> Other CDN)
```
Corrija permalinks e regras de reescrita do servidor: Se o 404 é na página inteira e não num asset, troque os permalinks de Padrão para Nome do post em Configurações -> Links Permanentes e salve para regravar o .htaccess. Em servidores Apache ou LiteSpeed isso recria o bloco BEGIN WP Rocket. Em Nginx não há .htaccess, então a regra de reescrita do cache precisa ser adicionada no arquivo de configuração do servidor (server block), conforme o guia oficial de Nginx do WP Rocket.
```
Configurações -> Links Permanentes -> Nome do post -> Salvar alterações
chmod 644 .htaccess
Apache/LiteSpeed: verificar bloco entre # BEGIN WP Rocket e # END WP Rocket no .htaccess
Nginx: adicionar a regra de cache do WP Rocket no server block (config do servidor)
```

NGINX

# Nginx: servir as paginas em cache do WP Rocket (no .htaccess nao existe no Nginx)
set $rocket_bypass 1;
if ($request_method = GET) { set $rocket_bypass 0; }
if ($args != "") { set $rocket_bypass 1; }
if ($http_cookie ~* "wordpress_logged_in_|wp-postpass_|woocommerce_items_in_cart") { set $rocket_bypass 1; }
set $rocket_file "/wp-content/cache/wp-rocket/$host/$request_uri/index.html";
if (-f $document_root$rocket_file) { set $rocket_bypass "${rocket_bypass}1"; }
if ($rocket_bypass = "01") { rewrite .* $rocket_file last; }

Perguntas frequentes

O WP Rocket erro 404 some se eu desativar o plugin?

Desativar resolve no curto prazo porque para de gerar arquivos combinados, mas você perde o cache. O certo é desligar só Combinar JavaScript e limpar o cache, mantendo o WP Rocket ativo e o ganho de performance.

Por que o 404 aparece só em alguns visitantes?

Porque o navegador ou um proxy intermediário guardou o HTML antigo, que aponta para o nome de arquivo minificado anterior. Quem tem cache local pede o arquivo velho, que já foi regenerado com outro nome, e recebe 404.

Minificar arquivos também causa 404 como combinar?

Não. Minificar reduz o arquivo sem trocar o nome, então a referência continua válida. Combinar é que junta vários arquivos num só e gera um nome novo a cada mudança, criando a referência quebrada que vira 404.

Como sei se o 404 é do asset ou da página?

Abra o DevTools do navegador na aba Network e recarregue. Se o status 404 está num arquivo .css ou .js de wp-content/cache/min, é asset. Se a URL principal do documento retorna 404, é a página, e o problema está em permalinks ou reescrita.

O 404 no WP Rocket tem a ver com permalinks?

Tem, quando o 404 é na página inteira. As regras que o WP Rocket grava no .htaccess para servir o cache dependem de permalinks amigáveis. Com a opção Padrão ativa, a reescrita falha e a página retorna 404.

Uso Nginx e tenho 404 depois do WP Rocket, o que muda?

No Nginx o WP Rocket não escreve no .htaccess, porque esse arquivo não existe lá. A regra que serve as páginas em cache precisa ser adicionada manualmente no server block, seguindo o guia oficial de Nginx, senão o cache devolve 404.

Limpar o cache do WP Rocket resolve o 404?

Resolve quando a causa é referência velha em cache, que é o caso mais comum. Use Limpar e pré-carregar o cache no menu do WP Rocket. Se o 404 voltar depois, a causa é estrutural (combinação, CDN ou permalink) e precisa do passo correspondente.

Grave

Como corrigir queries lentas no banco com JetEngine e ACF PRO no WordPress

As queries lentas do JetEngine e ACF PRO no banco acontecem quando listings e filtros disparam meta_query pesadas sobre a tabela wp_postmeta sem indice útil, ou quando muitos campos são gravados como meta em vez de uma tabela dedicada, forçando JOINs e leituras caras a cada carregamento.

Atenção

Como corrigir o erro de permissão ao limpar o banco no WP-Optimize

O erro de permissão no banco do WP-Optimize trava a limpeza quando o usuário MySQL definido no wp-config.php não tem o privilégio que o comando OPTIMIZE TABLE exige para recriar a tabela. O plugin marca cada otimização como falha e o overhead não cai. A correção é conceder o GRANT correto ao usuário do banco.

Grave

Como otimizar o wp_options para reduzir queries lentas no WordPress

O wp_options lento no WordPress acontece quando a tabela de opções carrega dados demais em autoload a cada requisição, pesando em todas as páginas. Costuma vir de autoload inchado, transients órfãos acumulados e lixo deixado por plugins desinstalados.

Atenção

Como corrigir o aviso de CSS não utilizado no WordPress

O aviso de unused CSS no WordPress aparece quando o PageSpeed Insights detecta folhas de estilo carregadas pela página, mas com regras que aquela página não aplica, o que pesa no LCP e no render. A correção gera o Used CSS por página com o Perfmatters e mantem o estilo usado, em vez de simplesmente apagar todo o CSS.

Atenção

Como corrigir o cache do WP Rocket em páginas de curso do Tutor LMS no WordPress

O cache do WP Rocket em páginas de curso do Tutor LMS quebra quando o WP Rocket serve uma versão estática de uma página que deveria ser personalizada por aluno, fazendo o progresso, o player de aula ou o status de matrícula aparecerem errados para quem está logado.

Atenção

Como corrigir o cache do WP-Optimize em páginas de curso do Tutor LMS

O cache do WP-Optimize em páginas de curso do Tutor LMS quebra quando o cache de página estático é servido a alunos logados: a versão deslogada congelada esconde o conteúdo liberado, o progresso e os botões de matrícula, porque o WP-Optimize entrega o mesmo arquivo HTML para todos sem o cache por usuário ativado.

Setores

Extensões

Integrações

Como corrigir o erro 404 após ativar o WP Rocket

O que é erro 404 do WP Rocket?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir queries lentas no banco com JetEngine e ACF PRO no WordPress

Como corrigir o erro de permissão ao limpar o banco no WP-Optimize

Como otimizar o wp_options para reduzir queries lentas no WordPress

Como corrigir o aviso de CSS não utilizado no WordPress

Como corrigir o cache do WP Rocket em páginas de curso do Tutor LMS no WordPress

Como corrigir o cache do WP-Optimize em páginas de curso do Tutor LMS

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