Cómo Solucionar el Error de Sitemap en Yoast SEO: «XML Declaration Allowed Only at the Start of the Document»

Dificultad Media

Si usas Yoast SEO en WordPress, podrías enfrentarte al frustrante error: «This page contains the following errors: error on line 2 at column 6: XML declaration allowed only at the start of the document». Este mensaje puede aparecer al intentar acceder al sitemap de tu sitio, y aquí te explicamos cómo resolverlo paso a paso para asegurarte de que tu sitemap funcione correctamente, mejorando así tu SEO.

Este error típicamente ocurre cuando hay contenido indebido, como espacios en blanco o líneas nuevas, antes de la declaración XML del sitemap. Dicho contenido puede provenir de archivos PHP mal configurados en tu tema o plugins. A continuación, te ofrecemos varias soluciones efectivas.

Paso 1: Revisar el Archivo Functions.php

A mí personalmente el problema que me ocurrió fue debido a los espacios en blanco del fichero functions.php de WordPress tras el cierre de la etiqueta PHP («?>»)

El archivo functions.php de tu tema activo es un buen punto de partida para descartar este aspecto y no volverte lokit@:

• Accede al editor de temas en WordPress bajo Apariencia > Editor de temas o a través de Filezilla
• Selecciona y abre el archivo functions.php.
• Verifica que no haya espacios antes de <?php o después de ?>. Si existe una etiqueta de cierre ?>, considera eliminarla para evitar espacios en blanco automáticos al final del archivo.

Paso 2: Inspeccionar Otros Archivos y Plugins

Si el error persiste tras ajustar el functions.php, examina otros archivos del tema y plugins:

• Prueba desactivar temporalmente cada plugin para determinar si el error se resuelve.
• Revisa otros archivos PHP dentro de tu tema que podrían estar agregando salida antes del inicio del documento.

Paso 3: Cambiar a un Tema por Defecto

Para descartar completamente que sea un problema del tema:

• Activa un tema predeterminado de WordPress como Twenty Twenty-One.
• Verifica si el sitemap se carga sin errores.
• Si el problema se resuelve, es probable que necesites revisar más detalladamente tu tema habitual o consultar con el desarrollador del tema.

Paso 4: Verificar Configuraciones del Servidor y .htaccess

Algunas configuraciones del servidor o reglas en el archivo .htaccess pueden causar este error:

• Asegúrate de que no haya directivas en .htaccess que modifiquen el comportamiento esperado de los archivos XML.

Paso 5: Limpiar la Caché

La caché puede ocultar el problema o prevenir que las soluciones tengan efecto inmediato:

• Limpia todas las cachés de tu sitio web y plugins, como WP Rocket o W3 Total Cache, después de hacer cambios.