Erro no feed RSS do WordPress: como corrigir o XML

Tipo Outros erros

Nome do erro Feed RSS com erro EN: RSS feed error

Severidade Atenção

Descrição O erro no feed RSS do WordPress aparece quando o navegador ou validador mostra uma falha de XML, normalmente porque há espaço ou texto antes da abertura do feed. A correção é localizar a saída extra (functions.php, wp-config.php ou plugin) e remover o espaço em branco antes da tag de XML.

O que é o feed RSS com erro?

O feed RSS com erro no WordPress é a falha em que a URL do feed (por exemplo, seudominio.com/feed) deixa de retornar um XML válido. Em vez da lista de posts, o navegador mostra uma mensagem como erro de análise de XML apontando a linha 1. O WordPress gera o feed como um documento XML puro, e qualquer caractere enviado antes da declaração do XML (um espaço, uma linha em branco ou um aviso de PHP) invalida o arquivo inteiro, porque a primeira linha precisa ser exatamente a declaração do XML.

Como identificar

Ao abrir seudominio.com/feed, o navegador mostra “XML Parsing Error: XML or text declaration not at start of entity” na linha 1.
O validador oficial responde “This feed does not validate” e aponta espaço em branco antes da declaração do XML.
Plugins de e-mail, agregadores e o Mailchimp param de puxar os posts novos do feed sem aviso.
Ao ver o código-fonte do feed, há uma linha em branco ou um aviso de PHP (Warning/Notice) antes da tag de abertura do XML.

Antes de começar: Antes de editar functions.php ou wp-config.php por FTP, baixe uma cópia de backup do arquivo. Um erro de sintaxe nesses arquivos pode derrubar o site inteiro com a tela branca da morte.

Como prevenir

Não use a tag de fechamento de PHP no final de functions.php e wp-config.php para evitar espaço em branco depois dela
Salve todos os arquivos PHP em UTF-8 sem BOM, já que a marca invisível conta como saída antes do XML
Valide o feed no validador do W3C após instalar plugins novos, que podem injetar saída ou gerar avisos de PHP

Causa

Há um espaço ou linha em branco depois do fechamento de PHP (a tag de fechamento) no functions.php do tema, que é enviado antes do XML.
O wp-config.php ou um plugin tem caracteres após o fechamento de PHP, e esse texto vaza para o início de toda resposta, inclusive o feed.
Um aviso de PHP (Warning ou Notice) de um plugin desatualizado é impresso na tela e aparece antes da declaração do XML do feed.
Um plugin de SEO ou de cache injeta HTML ou um comentário no topo da saída, quebrando o formato XML esperado pelo feed.
O arquivo functions.php foi salvo com codificação que adiciona um BOM (marca de ordem de byte) no início, contando como caractere antes do XML.

Como resolver

Valide o feed e localize o erro: abra o feed em seudominio.com/feed e use o validador oficial do W3C. A mensagem aponta se há espaço em branco antes do XML e em qual byte, o que confirma que é saída extra e não corrupção de dados.
Revise o final do functions.php: via FTP, abra o functions.php do tema ativo. Se houver a tag de fechamento de PHP no fim do arquivo, remova-a junto com qualquer espaço ou linha em branco depois dela. Um arquivo só de PHP não precisa de tag de fechamento.
Confira o wp-config.php: verifique se o wp-config.php termina sem espaço ou texto após o fechamento de PHP. Qualquer caractere depois dele é enviado antes do XML e quebra o feed.
Isole o plugin culpado: se os arquivos estão limpos, desative os plugins e reabra o feed. Quando ele voltar a validar, reative um por vez até o erro retornar, identificando o plugin que injeta saída ou gera o aviso de PHP.
Salve os arquivos sem BOM: se editou functions.php ou wp-config.php, salve em UTF-8 sem BOM. Editores comuns adicionam essa marca invisível no início, que conta como caractere antes do XML e mantém o feed quebrado.

PHP

// mu-plugin (wp-content/mu-plugins/sem-saida-feed.php): captura saida indevida antes do feed
// Use APENAS para diagnostico: descobre o arquivo que imprime algo cedo demais
add_action( 'init', function () {
    if ( is_feed() && headers_sent( $arquivo, $linha ) ) {
        error_log( sprintf(
            'Feed RSS quebrado: saida iniciada em %s na linha %d',
            $arquivo,
            $linha
        ) );
    }
}, 1 );

Perguntas frequentes

Por que meu feed RSS mostra erro de XML na linha 1?

Porque algo foi enviado antes da declaração do XML, que precisa ser o primeiro caractere do feed. Em geral é um espaço ou linha em branco depois do fechamento de PHP no functions.php ou no wp-config.php, ou um aviso de PHP impresso por um plugin.

O que significa espaço em branco antes do XML?

É qualquer caractere (espaço, quebra de linha ou texto) enviado antes da declaração do XML do feed. Como o feed é um documento XML puro, essa declaração deve abrir o arquivo. Qualquer coisa antes invalida o XML inteiro e gera o erro de análise.

Por que tirar a tag de fechamento de PHP resolve?

Porque qualquer espaço ou linha em branco depois dela é enviado ao navegador antes do feed. Arquivos que contêm só código PHP, como functions.php e wp-config.php, não precisam da tag de fechamento. Removê-la elimina a fonte mais comum de saída indevida.

Como sei qual plugin está quebrando o feed?

Desative todos os plugins e abra o feed. Se ele voltar a validar, reative um por vez, recarregando o feed a cada ativação, até o erro reaparecer. O plugin que estava sendo ativado nesse momento é o responsável pela saída ou pelo aviso de PHP.

O que é o BOM e por que quebra o feed?

BOM é uma marca de ordem de byte invisível que alguns editores adicionam no início de arquivos UTF-8. Mesmo sem aparecer, ela é enviada antes do XML e conta como caractere fora de lugar. Salve functions.php e wp-config.php em UTF-8 sem BOM para evitar isso.

Preciso de plugin para corrigir o feed RSS?

Não para corrigir a causa. O erro costuma estar em espaço em branco ou avisos de PHP nos arquivos do tema ou plugins, resolvido por FTP. Plugins ajudam só no diagnóstico ou para gerar o feed de forma alternativa, mas não substituem a limpeza da saída indevida.

Atenção

Como corrigir o certificado personalizado no Tutor LMS

O certificado personalizado no Tutor LMS depende do addon Certificates do Tutor LMS Pro e do plugin Certificate Builder. Quando um deles esta inativo, desatualizado ou o template não foi atribuido ao curso, o certificado some, não salva no construtor ou não chega ao aluno.

Atenção

Como corrigir HTTP error ao enviar imagem

O HTTP error ao enviar imagem é a mensagem genérica que o WordPress mostra quando o envio falha já dentro da Biblioteca de Mídia, depois de o arquivo chegar ao servidor. Na maioria dos casos é falta de memória PHP ou um problema no processador de imagem (ImageMagick) que trava na hora de gerar as miniaturas.

Atenção

Como corrigir o course archive que não exibe todos os cursos no Tutor LMS

O Tutor LMS course archive não mostra todos os cursos quando há cursos fora do status Publicado, paginação limitando a quantidade exibida, cache servindo uma versão antiga da página ou um filtro de categoria ativo escondendo parte da lista.

Atenção

Como corrigir o mapa do Google que não aparece no WordPress

O mapa do Google que não aparece no WordPress quase sempre indica uma chave de API ausente, restrita demais ou sem faturamento ativo na conta. O resultado é um bloco cinza, um mapa com a marca d'água 'For development purposes only' ou um erro no console; a correção é gerar e restringir corretamente a chave da Google Maps Platform.

Atenção

Como corrigir pré-requisitos de curso que não funcionam no Tutor LMS

O pré-requisito de curso do Tutor LMS não funciona quando o addon Prerequisites está desativado, quando o curso exigido como pré-requisito não está publicado, ou quando o tema não usa os templates do Tutor, fazendo o aluno se inscrever sem concluir o curso anterior.

Atenção

Como corrigir o campo de cálculos que não calcula no WPForms

O campo WPForms Calculations não calcula quando o addon Calculations não está ativo, quando o cálculo foi habilitado num tipo de campo não suportado ou quando a fórmula tem erro de validação, caso em que o WPForms ignora o cálculo e trata o campo como comum.

Setores

Extensões

Integrações

Como corrigir o feed RSS com erro no WordPress

O que é o feed RSS com erro?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o certificado personalizado no Tutor LMS

Como corrigir HTTP error ao enviar imagem

Como corrigir o course archive que não exibe todos os cursos no Tutor LMS

Como corrigir o mapa do Google que não aparece no WordPress

Como corrigir pré-requisitos de curso que não funcionam no Tutor LMS

Como corrigir o campo de cálculos que não calcula no WPForms

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