La référence des erreurs de sitemap se divise en deux groupes : les échecs de récupération du fichier et les échecs d’ analyse de celui-ci. La distinction est importante, car le premier groupe relève d’un problème de serveur et le second d’un problème de générateur, et ils sont traités par des personnes différentes.
Échecs de téléchargement
Non indexé (téléchargement échoué, URL probablement erronée), erreur HTTP (un statut autre que 200), URL invalide, connexion perdue, échec de connexion, erreur DNS, réponse HTTP incorrecte, réponse vide, erreur d’extraction gzip et URL interdite dans robots.txt — ce dernier cas étant entièrement auto-infligé et méritant d’être vérifié en premier.
Les limites strictes
- 50 Mo de taille maximale de fichier.
- 50 000 URL par fichier de sitemap — au-delà, divisez le fichier et utilisez un fichier d’index.
- 50 000 fichiers de sitemap par fichier d’index.
- 1 024 caractères de longueur maximale d’URL.
- 100 erreurs et le traitement s’arrête complètement.
La règle que la plupart des générateurs gèrent mal
L’URL ne correspond pas à l’emplacement du fichier de sitemap. Un sitemap dans un répertoire ne peut contenir que des URL provenant de ce répertoire ou de ses sous-répertoires. /sitemaps/products.xml Un fichier situé à listant des URL à la racine du site est invalide, et c’est exactement ce que produisent de nombreux plugins lorsqu’un sitemap est déplacé hors de la racine.
Encodage et structure
Le fichier doit commencer par le préfixe UTF-8 et la déclaration XML standard ; son absence constitue un avertissement (“encoding not UTF-8”) plutôt qu’une erreur. Les erreurs structurelles incluent les balises apparaissant plus d’une fois, les balises inattendues, les balises requises manquantes, les balises vides, les balises imbriquées là où aucune n’est autorisée et les balises contenant trop de données. Un XML invalide — un fichier qui n’est pas bien formé — bloque tout.
Deux conditions de fin prématurée
Yandex arrête le traitement lorsqu’il détecte plus de 100 erreurs, et également lorsqu’un fichier commence par des URL invalides consécutives, en supposant que le format est erroné. Ces deux situations signifient que la liste des erreurs signalées est incomplète, de sorte que corriger ce qui est affiché et soumettre à nouveau peut révéler un tout nouveau lot.
Imbrication
Un fichier d’index de sitemap ne peut faire référence qu’à des fichiers de sitemap — pas à d’autres fichiers d’index. Les structures profondément imbriquées sur les grands sites échouent ici.
L’avertissement à ignorer
“Unknown tag (ignored)” est souvent une extension de protocole de sitemap légitime pour un autre moteur. Yandex ignore la balise et traite le reste ; le fichier n’a pas besoin d’être modifié.
Comment nous l'appliquons
The error we see most often on client sites is the location rule — a plugin writing a sitemap into a subdirectory while listing root URLs — and the second is a 50,000-URL overflow on a catalogue that grew past the threshold without anyone noticing. Both produce a file that looks perfectly reasonable when opened in a browser. We check the sitemap after every catalogue expansion for exactly that reason.
Services associés