Combinar JavaScript no WP Rocket: erro e como corrigir

Tipo Performance & Velocidade

Nome do erro Erro de JavaScript ao combinar arquivos no WP Rocket EN: WP Rocket combine JavaScript error

Severidade Grave

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

Conteúdo exclusivo para membros Pro

Faça upgrade para acessar este item completo.

// ★ Conteúdo disponível para membros Pro...
// Faça upgrade para acessar este item.

Perguntas frequentes

Por que combinar JavaScript quebra meu site no WP Rocket?

Porque a opção junta todos os scripts em um único arquivo e altera a ordem de execucao. Quando um script depende de outro carregar antes, ou de uma variavel global definida por terceiro, a referencia acontece antes da hora e o navegador lanca um erro que interrompe o restante do JavaScript da página.

Como eu sei que o problema e o WP Rocket e não outro plugin?

Adicione o parametro de bypass no final da URL da página quebrada e recarregue. Esse parametro carrega a página sem nenhuma otimização do WP Rocket. Se o recurso voltar a funcionar, a causa esta na otimização de arquivos do plugin, e não em outro lugar.

Onde fica o campo para excluir um arquivo JavaScript do combine?

No painel, em WP Rocket -> File Optimization -> JavaScript Files. O campo se chama Excluded JavaScript Files. Você cola ali o caminho relativo do arquivo a partir de /wp-content/, um por linha, e salva.

Preciso usar a URL completa ou o caminho relativo na exclusão?

Use o caminho relativo a partir de /wp-content/, como /wp-content/plugins/nome-do-plugin/assets/js/script.js. Para excluir uma pasta inteira de arquivos, use o curinga no final do caminho. O caminho relativo cobre o arquivo mesmo que o domínio mude.

E se o erro vier de um código JavaScript inline, sem arquivo?

Nesse caso o campo Excluded JavaScript Files não resolve, porque ele trabalha com caminho de arquivo. Pegue uma string única do código inline e cole no campo Excluded Inline JavaScript, que faz a correspondencia por trecho de texto em vez de por caminho.

Devo desligar o combine ou so excluir o arquivo problematico?

Se o servidor entrega o site por HTTP/2 ou HTTP/3, desligar o combine raramente afeta a velocidade e elimina o risco de uma vez. Se você optar por manter o combine, exclua apenas o arquivo conflitante para preservar o ganho nos demais scripts.

Combinar e o mesmo que minificar JavaScript no WP Rocket?

Não. Minificar apenas remove espacos e comentarios de cada arquivo e quase nunca quebra o site. Combinar junta vários arquivos em um so e muda a ordem de execucao, que e justamente o que costuma gerar o erro. Por isso a Minify vem ativa por padrão e o Combine e opcional.

Depois de excluir o arquivo o erro continua, e agora?

Limpe o cache em WP Rocket -> Dashboard com Clear and preload cache e recarregue a página com recarga forte, porque o arquivo combinado antigo pode ter ficado em cache. Se persistir, volte ao console: pode haver um segundo arquivo gerando erro que também precisa entrar na lista de exclusão.

Pro 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.

Pro Grave

Como corrigir o WP Rocket que não gera cache

WP Rocket não gera cache é quando o plugin está ativo mas não cria o arquivo HTML estático da página, então o visitante recebe a versão dinâmica gerada pelo PHP a cada acesso. Confirma-se pela ausência do comentário "Debug: cached@" no fim do código-fonte da página, sinal de que aquela URL não foi cacheada.

Pro Grave

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

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.

Pro Grave

Como corrigir a integração de CDN do WP Rocket que não funciona

WP Rocket CDN não funciona é quando a opção Content Delivery Network está ativa mas o plugin não reescreve as URLs dos arquivos estáticos, então imagens, CSS e JS continuam saindo pelo domínio do site. No código-fonte, os assets ainda apontam para o domínio principal, e não para o CNAME informado.

Pro Atenção

Como otimizar o banco de dados WordPress para velocidade

Otimizar o banco de dados do WordPress é limpar e reorganizar as tabelas MySQL que acumulam dados desnecessários e ficam lentas com o tempo. O inchaço costuma vir de revisões de post, transients expirados, comentários de spam e tabelas órfãs deixadas por plugins removidos, que aumentam o tempo de cada query.

Pro 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.

Setores

Extensões

Integrações

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

Conteúdo exclusivo para membros Pro

Perguntas frequentes

Itens relacionados

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

Como corrigir o WP Rocket que não gera cache

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

Como corrigir a integração de CDN do WP Rocket que não funciona

Como otimizar o banco de dados WordPress para velocidade

Como corrigir o aviso de CSS não utilizado 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