--- title: "Como corrigir o erro de JavaScript ao combinar arquivos no WP Rocket" url: https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o erro de JavaScript ao combinar arquivos no WP Rocket ## O que é erro ao combinar JavaScript no WP Rocket? O erro de JavaScript ao combinar arquivos acontece quando a opção Combine JavaScript Files do WP Rocket, na aba File Optimization, junta todos os scripts da página em um único arquivo para reduzir requisicoes HTTP. Em sites que ainda usam HTTP/1 isso e uma boa prática, mas a juncao muda a ordem de execucao e o escopo das variaveis. Quando um script depende de outro carregar antes, ou de uma variavel global definida por terceiro, a ordem se perde e o navegador lanca um erro que interrompe o restante do JavaScript da página. O resultado visivel e um recurso interativo (menu mobile, carrossel, slider, lightbox, formulário, contador) que simplesmente para de funcionar, mesmo o site carregando sem mensagem de erro na tela. Por isso a própria WP Rocket trata Combine JavaScript como recurso opcional, com exclusoes automaticas para compatibilidade com temas e plugins. ## Como identificar - No console do navegador (F12, aba Console) aparece um erro vermelho como 'Uncaught ReferenceError: jQuery is not defined' ou 'Uncaught TypeError: ... is not a function', apontando para o arquivo combinado em /wp-content/cache/min/ - Menu mobile, carrossel, slider, lightbox ou accordion para de abrir ou de animar depois de ativar a opção Combine JavaScript Files - Formulários (Contact Form 7, WPForms, Elementor) não enviam, não validam ou perdem a mascara de campo - Ao abrir a mesma página com o parametro ?nowprocket no final da URL, todos os recursos voltam a funcionar — confirmando que a causa esta na otimização do WP Rocket - O problema some quando a opção Combine JavaScript Files e desligada e volta quando ela e religada ## Como prevenir - Se o servidor já entrega o site por HTTP/2 ou HTTP/3, mantenha Combine JavaScript Files desligado: a concatenacao so traz ganho real em HTTP/1, e desligada evita esse tipo de conflito de ordem. - Ative uma otimização de cada vez (Minify, depois Combine, depois Delay) e teste a página antes de ativar a próxima, para isolar rapidamente qual delas quebra o site. - Não use Combine JavaScript Files e Delay JavaScript Execution ao mesmo tempo; a WP Rocket desativa o Combine automaticamente quando o Delay esta ativo. - Após atualizar tema ou plugins pesados em JavaScript, revalide as páginas com recursos interativos, já que arquivos novos podem entrar no combine e reintroduzir o conflito. Erros relacionados - [Como corrigir o conflito entre Elementor e WP Rocket no WordPress](https://full.services/wp-fixer/corrigir-conflito-elementor-wp-rocket/) - [Como corrigir widgets do Essential Addons quebrados pelo cache do WP Rocket](https://full.services/wp-fixer/corrigir-cache-wp-rocket-essential-addons/) - [Como corrigir o WP Rocket que não gera cache](https://full.services/wp-fixer/corrigir-wp-rocket-nao-gera-cache/) --- ## Metadados Estruturados (Schema.org) ```json-ld { "@context": "https://schema.org", "@graph": [ { "@type": "Organization", "@id": "https://full.services/#org", "name": "FULL Services", "url": "https://full.services/", "sameAs": [ "https://www.instagram.com/fullservicesbr", "https://www.facebook.com/fullservices.br", "https://www.linkedin.com/company/fullservicesbr/" ], "knowsAbout": [ "WordPress", "WordPress Hosting", "Web Development", "Performance Optimization", "WordPress Security", "SEO para WordPress" ], "award": [ "Gold Medal - The WP Weekly Awards 2023", "Gold Medal - The WP Weekly Awards 2024" ], "logo": { "@type": "ImageObject", "url": "https://full.services/wp-content/uploads/full-services-logo.png", "width": 200, "height": 60 }, "hasCredential": { "@type": "EducationalOccupationalCredential", "credentialCategory": "certification", "name": "CVE Numbering Authority (CNA)", "description": "Autoridade de numeração de vulnerabilidades (CVE) para o ecossistema WordPress, autorizada a atribuir IDs CVE. Válida desde 2022-05-03, com abrangência global.", "url": "https://www.cve.org/PartnerInformation/ListofPartners/partner/FULL", "recognizedBy": { "@type": "Organization", "name": "CISA — Cybersecurity and Infrastructure Security Agency", "url": "https://www.cisa.gov/", "sameAs": "https://www.cisa.gov/" } } }, { "@type": "TechArticle", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#article", "headline": "Como corrigir o erro de JavaScript ao combinar arquivos no WP Rocket", "url": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:29-03:00", "dateModified": "2026-06-17T12:39:29-03:00", "author": { "@id": "https://full.services/#org" }, "publisher": { "@id": "https://full.services/#org" }, "isAccessibleForFree": false, "about": [ { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, { "@type": "Thing", "name": "Performance & Velocidade" } ], "mentions": { "@type": "Thing", "@id": "https://www.wikidata.org/wiki/Q13166", "name": "WordPress", "sameAs": "https://www.wikidata.org/wiki/Q13166", "url": "https://wordpress.org/" }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/" }, "wordCount": 873, "description": "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.", "articleSection": "Performance & Velocidade", "keywords": "combine javascript files wp rocket quebra site, excluded javascript files wp rocket caminho, menu nao abre depois do wp rocket, wp rocket combinar javascript carrossel parou, wp rocket excluir arquivo javascript do combine", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://docs.wp-rocket.me/article/1351-javascript-minify-combine", "name": "WP Rocket — Minify JavaScript files and Combine JavaScript files" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o erro de JavaScript ao combinar arquivos no WP Rocket", "programmingLanguage": "JavaScript", "codeRepository": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#faq-q1", "name": "Por que combinar JavaScript quebra meu site no WP Rocket?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#faq-q2", "name": "Como eu sei que o problema e o WP Rocket e não outro plugin?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#faq-q3", "name": "Onde fica o campo para excluir um arquivo JavaScript do combine?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#faq-q4", "name": "Preciso usar a URL completa ou o caminho relativo na exclusão?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#faq-q5", "name": "E se o erro vier de um código JavaScript inline, sem arquivo?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#faq-q6", "name": "Devo desligar o combine ou so excluir o arquivo problematico?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#faq-q7", "name": "Combinar e o mesmo que minificar JavaScript no WP Rocket?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-combinar-javascript-wp-rocket/#faq-q8", "name": "Depois de excluir o arquivo o erro continua, e agora?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "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.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```