Sitemap Rank Math quebrado pelo WP Rocket: como corrigir

Tipo SEO Tecnico

Nome do erro Sitemap do Rank Math quebrado pelo cache do WP Rocket EN: Rank Math sitemap broken by WP Rocket cache

Severidade Grave

Descrição O sitemap do Rank Math quebra quando o WP Rocket guarda uma cópia estática do sitemap_index.xml ou aplica minificação de HTML, CSS e JS sobre a saída XML. A correção é excluir o caminho do sitemap do cache e do minify do WP Rocket e limpar o cache.

O que é sitemap do Rank Math quebrado pelo cache do WP Rocket?

O sitemap do Rank Math quebrado pelo cache do WP Rocket acontece quando o WP Rocket trata o sitemap_index.xml como uma página HTML comum: guarda uma versão estática no diretório de cache e aplica as otimizações de minificação sobre a resposta. O Rank Math gera o índice em sitemap_index.xml junto com uma folha de estilo XSL (o arquivo de transformação que deixa o sitemap legível no navegador) e sub-sitemaps por tipo de post; quando o WP Rocket entra no meio, o Googlebot e o visitante recebem um XML antigo, sem estilo ou com lixo de minificação antes da declaração XML.

Na prática são dois mecanismos distintos. O primeiro é o cache de página: o WP Rocket serve um sitemap_index.xml congelado de horas atrás, então posts novos não aparecem para o Google. O segundo é a minificação: ao processar o XSL e os scripts associados, o WP Rocket injeta caracteres ou remove a estrutura que o parser de XML espera, e o navegador acusa erro de declaração XML ou exibe a página sem formatação. Separar qual dos dois está ativo é o que leva à correção certa em vez do chute de desativar o plugin inteiro.

Como identificar

O sitemap_index.xml abre sem a folha de estilo do Rank Math: aparece o XML cru, sem a tabela azul de URLs que o Rank Math normalmente mostra
O navegador exibe o erro “XML Parsing Error: XML or text declaration not at the start of entity” ao abrir o sitemap com o WP Rocket ativo
Posts e páginas publicados há horas não aparecem no sitemap_index.xml, mas surgem assim que você limpa o cache do WP Rocket
No Search Console o sitemap fica em “Couldn’t fetch” ou “Sitemap could not be read”, enquanto o arquivo abre normalmente para você com o cache já quente
Ao testar domínio.com/?sitemap=1 o sitemap vem correto e atualizado, mas a URL amigável sitemap_index.xml vem antiga ou sem estilo
O problema some quando você desativa o WP Rocket e volta a aparecer poucos minutos depois de reativar, quando o cache do sitemap é regerado

Antes de começar: Faça backup das configurações do WP Rocket antes de alterar as regras de cache e minify. Elas ficam na option wp_rocket_settings e um backup permite reverter caso a exclusão do sitemap afete outra otimização do site.

Como prevenir

Logo após instalar o WP Rocket, adicione o caminho do sitemap ao campo Never Cache URL(s) para o índice nunca ser servido estático ao Googlebot
Mantenha o sitemap.xsl fixo nas listas de exclusão de CSS e JS do WP Rocket para que novas otimizações nunca removam a folha de estilo do sitemap
Depois de publicar um lote grande de posts, limpe o cache do WP Rocket e confira o sitemap_index.xml em janela anônima antes de aguardar o rastreamento do Google
Ao atualizar o WP Rocket ou o Rank Math, valide o sitemap em janela anônima com cache limpo, pois uma nova versão pode reativar o Minify HTML sobre o XML

Causa

O cache de página do WP Rocket guarda uma cópia estática do sitemap_index.xml no diretório wp-content/cache/wp-rocket e serve essa versão congelada para o Googlebot, sem refletir os posts publicados depois.
A opção Minify HTML (aba File Optimization) processa a saída do sitemap_index.xml e da folha XSL, removendo quebras de linha que o parser de XML exige e gerando o erro de declaração XML fora do início.
As opções Minify/Combine CSS e Minify/Combine JS atuam sobre o sitemap.xsl que estiliza o sitemap, deixando o sitemap_index.xml sem a tabela visual e exibindo só o XML cru no navegador.
O caminho do sitemap não está no campo Never Cache URL(s) (aba Advanced Rules), então o WP Rocket nunca foi instruído a deixar o sitemap_index.xml fora do cache de página.
O Remove Unused CSS ou o Load CSS Asynchronously remove a referência ao sitemap.xsl, e o navegador renderiza o índice sem a folha de estilo de transformação.
O cache interno do próprio Rank Math também guarda o índice, então mesmo após purgar o WP Rocket o sitemap_index.xml volta antigo até a regeneração do Rank Math.

Como resolver

Confirme que a causa é o WP Rocket comparando a query crua: Antes de mexer em qualquer ajuste, descubra se o estrago vem do cache ou do minify. Abra as duas URLs em uma janela anônima e compare. Se a query crua vem certa e com estilo, mas a URL amigável vem antiga ou sem a tabela azul, o culpado é o WP Rocket.
```
https://seudominio.com/?sitemap=1
https://seudominio.com/sitemap_index.xml
```
Exclua o sitemap do cache de página no Advanced Rules: No painel, vá em Settings -> WP Rocket -> Advanced Rules e localize o campo Never Cache URL(s). Cole, uma por linha, os padrões que cobrem o índice e os sub-sitemaps. O WP Rocket passa a entregar sempre o XML gerado na hora pelo Rank Math em vez da cópia estática.
```
/sitemap_index.xml
/.*sitemap.*.xml
/sitemap.xsl
```
Tire o sitemap da minificação de HTML, CSS e JS: Vá em Settings -> WP Rocket -> File Optimization. Se o erro é XML declaration not at the start of entity, desligue o Minify HTML, pois ele quebra a estrutura do XML. Para o sitemap sem estilo, exclua o sitemap.xsl da combinação e minificação de CSS e JS para preservar a folha de transformação.
```
File Optimization -> CSS Files -> Excluded CSS Files: sitemap.xsl
File Optimization -> JavaScript Files -> Excluded JavaScript Files: sitemap.xsl
File Optimization -> desmarcar Minify HTML se o erro for de declaração XML
```
Limpe o cache do WP Rocket e regenere o sitemap do Rank Math: Volte em Settings -> WP Rocket -> Dashboard e clique em Clear and preload cache para descartar a cópia estática antiga. Depois force o Rank Math a remontar o índice reabrindo e salvando as configurações de sitemap, e confirme que os tipos de post estão marcados.
```
Settings -> WP Rocket -> Dashboard -> Clear and preload cache
Rank Math SEO -> Sitemap Settings -> Geral -> reabrir e salvar
```
Se o XML antigo persistir, desligue o cache do sitemap no Rank Math: Quando a cópia estática insiste em voltar mesmo após a purga, desative o cache interno do sitemap do Rank Math pelo filtro do passo de código. Assim o Rank Math monta o sitemap_index.xml a cada requisição e o WP Rocket, já com a URL excluída, repassa essa saída fresca ao Google.

PHP

<?php
// functions.php do tema ativo (ou um mu-plugin).
// Desliga o cache interno do sitemap do Rank Math quando o WP Rocket
// insiste em servir um sitemap_index.xml estático e desatualizado.
add_filter( 'rank_math/sitemap/enable_caching', '__return_false' );

Perguntas frequentes

Por que o sitemap_index.xml aparece sem estilo só depois que ativo o WP Rocket?

Porque o WP Rocket minifica ou combina o sitemap.xsl, que é a folha de estilo que transforma o XML na tabela visual do Rank Math. Sem ela, o navegador mostra o XML cru. Excluir o sitemap.xsl das listas de CSS e JS do WP Rocket devolve o estilo ao sitemap.

O que significa o erro XML declaration not at the start of entity no sitemap?

Significa que algo foi enviado antes da declaração XML, em geral pela minificação de HTML do WP Rocket atuando sobre o sitemap_index.xml. Desligar o Minify HTML ou excluir o caminho do sitemap do cache resolve, pois o XML volta a sair limpo do Rank Math.

Preciso desativar o WP Rocket inteiro para o sitemap voltar a funcionar?

Não. Basta adicionar o caminho do sitemap ao campo Never Cache URL(s) em Advanced Rules e excluir o sitemap.xsl da minificação. Assim você mantém o cache e o ganho de velocidade no restante do site sem quebrar o sitemap do Rank Math.

Por que o Google reporta Couldn't fetch se o sitemap abre normal para mim?

Porque o Googlebot recebe a versão em cache do WP Rocket, que pode estar antiga ou sem o XML válido, enquanto você vê a cópia já regenerada. Excluir o sitemap do cache faz o Googlebot receber sempre a saída fresca do Rank Math e o status volta a Success.

Como excluo o sitemap do cache do WP Rocket sem mexer no resto?

Vá em Settings -> WP Rocket -> Advanced Rules e cole o padrão do sitemap no campo Never Cache URL(s), uma URL por linha. Esse campo isola só o sitemap do cache de página e não afeta as demais URLs nem as otimizações ativas do site.

Depois de excluir o sitemap, ainda preciso limpar o cache?

Sim. A cópia estática antiga continua no diretório de cache até você purgar. Clique em Clear and preload cache no Dashboard do WP Rocket para descartar a versão congelada e forçar o WP Rocket a respeitar a nova regra de exclusão do sitemap.

O cache do próprio Rank Math também pode guardar o sitemap antigo?

Pode. O Rank Math mantém um cache interno do índice. Quando o XML antigo volta mesmo após purgar o WP Rocket, aplique o filtro rank_math/sitemap/enable_caching retornando falso para o Rank Math montar o sitemap a cada requisição, ao custo de um pouco mais de processamento.

A regra Never Cache URL(s) aceita curinga para pegar todos os sub-sitemaps?

Sim. O WP Rocket interpreta o campo como expressão e aceita padrões como uma linha cobrindo qualquer arquivo .xml de sitemap. Isso garante que tanto o índice quanto os sub-sitemaps por tipo de post fiquem fora do cache de página de uma vez.

Atenção

Como corrigir conteúdo duplicado no WordPress com Elementor

O conteúdo duplicado no Elementor ocorre quando o mesmo texto fica acessivel por mais de uma URL (template, anexo, paginação ou versão com parametros) sem um canonical apontando para a versão oficial, fazendo o Google indexar copias da mesma página.

Grave

Como corrigir o schema de produto do Rank Math no WooCommerce

O schema de produto do Rank Math no WooCommerce fica invalido quando o markup sai sem offers, review ou aggregateRating, quando aparece em páginas de arquivo, ou quando o WooCommerce duplica a marcacao Product.

Atenção

Como corrigir canibalizacao de keyword no WordPress com Rank Math

A canibalizacao de keyword no WordPress ocorre quando duas ou mais páginas do mesmo site disputam o mesmo termo de busca, dividindo cliques, autoridade e sinais de relevancia. O Rank Math ajuda a detectar a focus keyword repetida e a corrigir com consolidacao, canonical ou redirecionamento 301.

Atenção

Como corrigir o sitemap duplicado entre Rank Math, SEOPress e Yoast

O sitemap duplicado Rank Math, SEOPress e Yoast ocorre quando mais de um plugin de SEO fica ativo e cada um registra a rota sitemap_index.xml. O resultado são duas versões do mesmo sitemap na mesma URL, sitemaps órfãos no Search Console e indexação inconsistente. A correção é manter um único gerador de sitemap ativo.

Grave

Como corrigir problemas de indexação do sitemap Rank Math no Google

O sitemap do Rank Math fica como Couldn't fetch no Search Console quando o sitemap_index.xml retorna 404, HTML ou XML com lixo antes da abertura. O Google só lê o arquivo depois que a rota, o cache e o robots.txt liberam a saída XML pura.

Informativo

Como corrigir o erro de llms.txt no SEOPress

O erro de llms.txt no SEOPress acontece quando o recurso esta desligado no painel ou quando as regras de reescrita do WordPress não foram atualizadas, fazendo o endereco /llms.txt retornar 404 ou vir em branco.

Setores

Extensões

Integrações

Como corrigir o sitemap do Rank Math quebrado pelo cache do WP Rocket

O que é sitemap do Rank Math quebrado pelo cache do WP Rocket?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir conteúdo duplicado no WordPress com Elementor

Como corrigir o schema de produto do Rank Math no WooCommerce

Como corrigir canibalizacao de keyword no WordPress com Rank Math

Como corrigir o sitemap duplicado entre Rank Math, SEOPress e Yoast

Como corrigir problemas de indexação do sitemap Rank Math no Google

Como corrigir o erro de llms.txt no SEOPress

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