--- title: "Como corrigir o erro de Preload no WP Rocket" url: https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/ date: 2026-06-17 author: "Clayton Margiotti" --- # Como corrigir o erro de Preload no WP Rocket ## O que é o erro de Preload no WP Rocket? O Preload e a feature do WP Rocket que gera os arquivos de cache antecipadamente, simulando uma visita a cada página antes de qualquer visitante real chegar. Por padrão ele le os sitemaps dos plugins de SEO (Yoast, Rank Math, All in One SEO, SEOPress, The SEO Framework) ou o sitemap nativo do WordPress, descobre as URLs e vai preenchendo o cache uma a uma, registrando o progresso na tabela wp_wpr_rocket_cache do banco. O robo processa até 45 URLs por minuto e reduz o ritmo sozinho se o servidor ficar sob carga. O disparo da fila depende do WP-Cron: e ele que chama o processamento em segundo plano. O erro de Preload e justamente quando essa engrenagem para: a fila fica parada, as URLs nunca saem do estado pendente e o cache não e preenchido. Como o WP Rocket não para o site nem mostra erro fatal, o sintoma costuma passar despercebido até alguem notar que a primeira visita de cada página continua lenta. ## Como identificar - No painel, em WP Rocket -> Dashboard, a barra de progresso do Preload nunca chega a 100 por cento ou fica parada no mesmo número por muito tempo - A pasta de cache em wp-content/cache/wp-rocket fica vazia ou com pouquissimos arquivos, mesmo depois de clicar em Clear and preload cache - Na tabela wp_wpr_rocket_cache as linhas das URLs continuam com status pendente e nunca passam para concluido - O PageSpeed Insights e o teste de TTFB mostram a primeira visita de cada página lenta, e so a segunda visita (já em cache) fica rápida - Em sites com Yoast ou Rank Math, o WP Rocket não encontra URLs para preload porque o sitemap retorna vazio ou da erro ao ser aberto **Antes de começar:** Ao liberar o user-agent do preload na allowlist, restrinja a liberacao apenas a esse user-agent. Não desative o firewall por completo nem libere acesso irrestrito ao servidor so para destravar o preload. ## Como prevenir - Configure um cron real no servidor em vez de confiar no WP-Cron: assim a fila de preload anda mesmo em sites de baixo tráfego, que quase nunca disparam o cron padrão. - Mantenha o sitemap do plugin de SEO sempre gerado e acessivel, já que e a fonte de URLs do preload; um sitemap quebrado deixa a fila vazia. - Deixe o user-agent do preload do WP Rocket na allowlist do firewall e do Cloudflare desde o inicio, evitando que o robo seja barrado quando novas páginas forem publicadas. - Antes de publicar, tire o site de modo de manutenção e de proteção por senha, porque o robo de preload enxerga a página como um visitante anonimo qualquer. Erros relacionados - [Como corrigir o WP Rocket que não gera cache](https://full.services/wp-fixer/corrigir-wp-rocket-nao-gera-cache/) - [Como corrigir o erro de sitemap preload no WP Rocket](https://full.services/wp-fixer/corrigir-sitemap-wp-rocket/) - [Como corrigir erros de integração entre WP Rocket e Cloudflare](https://full.services/wp-fixer/corrigir-integracao-wp-rocket-cloudflare/) --- ## 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-erro-preload-wp-rocket/#article", "headline": "Como corrigir o erro de Preload no WP Rocket", "url": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/", "inLanguage": "pt-BR", "datePublished": "2026-06-17T12:39:30-03:00", "dateModified": "2026-06-17T12:39:30-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-erro-preload-wp-rocket/" }, "wordCount": 1198, "description": "O erro de Preload no WP Rocket acontece quando o robo que gera o cache antecipado não consegue percorrer as URLs do site: a fila nunca esvazia ou nem comeca. O resultado e um site com cache vazio, que so fica rápido para o segundo visitante de cada página, anulando o ganho do preload.", "articleSection": "Performance & Velocidade", "keywords": "fila de preload wp rocket parada, preload do wp rocket lento, wp rocket nao preenche o cache, wp rocket preload nao funciona, wp rocket preload travado", "proficiencyLevel": "Intermediate", "citation": { "@type": "CreativeWork", "url": "https://docs.wp-rocket.me/article/8-preload-cache", "name": "WP Rocket — Preload Cache" }, "mainEntity": { "@type": "SoftwareSourceCode", "name": "Como corrigir o erro de Preload no WP Rocket", "programmingLanguage": "PHP", "codeRepository": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/", "isAccessibleForFree": false } }, { "@type": "FAQPage", "@id": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/#faq", "isPartOf": { "@id": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/#article" }, "isAccessibleForFree": true, "mainEntity": [ { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/#faq-q1", "name": "O que significa o erro de Preload no WP Rocket?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Significa que o robo de preload do WP Rocket não consegue percorrer as URLs do site para gerar o cache antecipado. A fila fica parada ou nem comeca, as páginas seguem com status pendente e o cache não e preenchido. Na prática, a primeira visita de cada página continua lenta, que e justamente o que o preload deveria evitar.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/#faq-q2", "name": "Por que a fila de preload do WP Rocket nunca termina?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Quase sempre porque o WP-Cron não esta rodando: e ele que dispara o processamento em segundo plano. Se a constante de desativar o cron estiver ligada, ou se o site tiver tráfego baixo demais para o cron ser chamado, a fila não anda. A solução e garantir o cron ativo e, em sites pequenos, configurar um cron real no servidor.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/#faq-q3", "name": "O preload precisa do sitemap para funcionar?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim. Por padrão o WP Rocket le o sitemap do plugin de SEO (Yoast, Rank Math, All in One SEO, SEOPress ou The SEO Framework) para descobrir quais URLs preencher. Se o sitemap não abre, volta vazio ou não existe, a fila de preload fica sem URLs para percorrer. Gere e teste o sitemap antes de investigar outras causas.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/#faq-q4", "name": "Um plugin de segurança pode travar o preload?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Pode. Plugins como Wordfence, AIOS e iThemes, além do firewall do servidor e do Bot Fight Mode do Cloudflare, podem bloquear o user-agent WP Rocket/Preload, tratando o robo como bot. Quando isso acontece, o robo e barrado antes de carregar a página e a fila trava. Libere o user-agent do preload na allowlist para resolver.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/#faq-q5", "name": "Por que páginas com query string não recebem preload?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "O WP Rocket não faz preload de URLs que tenham parametros de query string na ponta, nem das páginas que estão na lista de exclusão. Esse e um comportamento esperado. Para que essas páginas entrem na fila, use a URL canonica sem parametros e revise o campo de URLs excluidas para tirar de la o que deveria ser preloadado.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/#faq-q6", "name": "O que e a tabela wp_wpr_rocket_cache?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "E a tabela do banco onde o WP Rocket registra o estado de cada URL do preload, da mais antiga para a mais recente. Quando o preload trava, as linhas dessa tabela ficam com status pendente e nunca passam para concluido. Olhar essa tabela ajuda a confirmar se a fila esta parada ou apenas lenta.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/#faq-q7", "name": "Falta a extensão SimpleXML pode causar o erro de preload?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Sim. O WP Rocket usa a extensão SimpleXML do PHP para ler o XML do sitemap. Se essa extensão não estiver habilitada na versão de PHP do site, o parse do sitemap falha em silencio e nenhuma URL entra na fila de preload. Peca a hospedagem para habilitar a SimpleXML e force um novo preload depois.", "author": { "@id": "https://full.services/#org" } } }, { "@type": "Question", "@id": "https://full.services/wp-fixer/corrigir-erro-preload-wp-rocket/#faq-q8", "name": "O preload funciona em site protegido por senha ou em staging?", "inLanguage": "pt-BR", "acceptedAnswer": { "@type": "Answer", "text": "Não de forma confiavel. O robo de preload enxerga a página como um visitante anonimo, entao modo de manutenção, proteção por senha (HTTP Auth) e ambientes de staging fechados barram o acesso e travam a fila. Tire essas barreiras no ambiente de producao antes de esperar que o preload preencha o cache.", "author": { "@id": "https://full.services/#org" } } } ] } ] } ```