Przejdź do treści

Błędy XML w mapie witryny: Błąd analizy składni, Brak tagu XML i inne

Google pobrał plik, ale nie przeczytał go w całości jako mapy witryny. Przy większości tych błędów Search Console podaje numer wiersza. Zacznij od niego.

W raporcie Mapy witryn:Błąd analizy składni

Ten poradnik obejmuje też: "Nieprawidłowy XML: zbyt wiele tagów" · "Brak tagu XML" · "Brak atrybutu XML" · "Nieprawidłowa wartość tagu" · "Nieprawidłowa wartość atrybutu" · "Nieobsługiwany format" · "Nieprawidłowa przestrzeń nazw" · "Wiodąca spacja"

Autor: Bruno Amorim · ·

Czytaj w innym języku: English · Português (Brasil) · Español · Deutsch · Français · Italiano · 日本語 · 한국어

Gdzie to zobaczysz

Na stronie szczegółów mapy w Indeksowanie > Mapy witryn, pod komunikatem „Mapa witryny może zostać odczytana, ale zawiera błędy”. Rozwiń błąd, żeby zobaczyć numer wiersza.

Najczęstsze przyczyny

  • Niezakodowany znak specjalny w adresie: & trzeba zapisać jako &amp;. Cudzysłowy oraz < i > też wymagają kodowania.
  • Motyw albo wtyczka wypisuje spacje, puste wiersze albo komunikaty PHP przed <?xml.
  • Zła przestrzeń nazw, na przykład 0.9 zapisane jako .9.
  • Plik robiony ręcznie, z cudzysłowami drukarskimi z edytora tekstu albo zdublowanym tagiem.
  • Plik nie jest zapisany w UTF-8. Google wymaga UTF-8 dla map witryn.

Każdy komunikat i jego poprawka

  • Błąd analizy składni: zakoduj &, ', ", < i > w każdej wartości.
  • Nieprawidłowy XML: zbyt wiele tagów: mapa ma zdublowane tagi, na przykład dwa <loc> w jednym <url>. Usuń duplikat.
  • Brak tagu XML: każdy <url> potrzebuje <loc>, każdy <sitemap> w indeksie też.
  • Brak atrybutu XML: dodaj wymagany atrybut.
  • Nieprawidłowa wartość tagu: sprawdź wartość z zasadami dla typu mapy: zwykłej, indeksu, obrazów, wideo albo wiadomości.
  • Nieprawidłowa wartość atrybutu: sprawdź literówki i używaj tylko dozwolonych wartości.
  • Nieobsługiwany format: zacznij plik od deklaracji XML i używaj prostych cudzysłowów.
  • Nieprawidłowa przestrzeń nazw: użyj poprawnej przestrzeni nazw na <urlset> albo <sitemapindex>.
  • Wiodąca spacja: plik zaczyna się od spacji przed deklaracją XML. Google i tak czyta mapę, ale usuń je.
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://example.com/sklep?kolor=czerwony&amp;rozmiar=40</loc>
  </url>
</urlset>

Jak to naprawić

  1. Rozwiń błąd w Search Console i zanotuj numer wiersza.
  2. Otwórz mapę w przeglądarce i wyświetl źródło. Sprawdź, czy pierwsze znaki to <?xml.
  3. Przepuść plik przez walidator XML, żeby znaleźć dokładny wiersz.
  4. Popraw wiersz albo ustawienie, które go tworzy, zapisz plik w UTF-8 i prześlij mapę ponownie.

WordPress

Dodatkowy tekst przed <?xml zwykle pochodzi z pliku functions.php motywu albo z wtyczki. Wyłączaj wtyczki po kolei albo na chwilę włącz domyślny motyw i odśwież mapę.

Jak pomaga CrawlCoach

Gdy Search Console zgłasza błędy XML w Twojej mapie, CrawlCoach w płatnych planach dodaje poprawkę do listy poprawek, z krokami i linkiem do tego poradnika.

Częste pytania

Jak naprawić błąd analizy składni w mapie witryny?

Rozwiń błąd w Search Console, żeby znaleźć wiersz. Częsta przyczyna to & w adresie, które nie jest zapisane jako &amp;. Jeśli mapę tworzy wtyczka, zaktualizuj ją albo zgłoś wiersz jej autorowi.

Jak naprawić Brak tagu XML?

W wierszu, który pokazuje Search Console, brakuje wymaganego tagu. Każdy <url> potrzebuje <loc> z pełnym adresem strony. Każdy wpis <sitemap> w indeksie też potrzebuje <loc>.

Co oznacza Nieobsługiwany format?

Google nie przeczytał pliku jako mapy witryny. Sprawdź nagłówek i przestrzeń nazw, zamień cudzysłowy drukarskie na proste. Mapą może być też kanał RSS lub Atom albo plik tekstowy z jednym adresem w wierszu.

Źródła

Sprawdzone 8 października 2026. Google co jakiś czas zmienia Search Console i pomoc. Jeśli na Twoim ekranie coś wygląda inaczej, zajrzyj do źródła.

Zobacz, których stron Twojej witryny brakuje w Google

Zaloguj się przez Google. CrawlCoach bezpłatnie sprawdzi do 500 stron i pokaże poprawkę dla każdego problemu.

Odbierz darmowy raport

Bezpłatnie do 500 stron. Bez karty płatniczej. Zaloguj się kontem Google, którego używasz w Search Console.

Aplikacja i raporty CrawlCoach są po angielsku.

Powiązane błędy

Więcej poradników (po angielsku)