XML-webhelytérkép hibaelhárítás
A webhelytérkép állapotvizsgálata, és a leggyakoribb hibák: üres oldal, 404, gyorsítótár, Google Search Console hibák.
Ha az XML-webhelytérkép nem működik, vagy hibát ad, kezdd a beépített állapotvizsgálattal, utána nézd végig az alábbi eseteket.

A képen a Sitemap health check blokk és a Test my sitemap gomb látszik; fölötte a térkép címe (/sitemaps.xml) a Copy és View gombbal.
Állapotvizsgálat
Szekció neve “Állapotvizsgálat”- Menj a SEO → XML - HTML Sitemap oldalra, General fül.
- Kattints a Test my sitemap gombra.
Az eredmény háromféle lehet: a térkép rendben van, működik, de van figyelmeztetés, vagy hibát találtál. Minden ellenőrzéshez állapot és magyarázat tartozik, ahol lehet, egykattintásos javítás is (például 404-nél a permalinkek frissítése).
A vizsgálat ellenőrzi, hogy:
- az XML-térkép funkció be van kapcsolva,
- a térkép elérhető (HTTP 200, nincs 404, 5xx, 401, 403),
- XML-ként érkezik, nem HTML-ként (gyorsítótár vagy CDN beavatkozása),
- az XML érvényes (nincs BOM és üres sor a
<?xmlelőtt), - a gyökérelem valódi térkép (
<sitemapindex>vagy<urlset>), - a térkép nem üres, és nem lépi át az 50 000 URL-es korlátot,
- az XSL stíluslap betöltődik,
- az al-térképek (bejegyzések, taxonómiák, szerzők, videó, hírek) válaszolnak,
- a permalinkek szép szerkezetűek,
- a keresőmotorok nincsenek kizárva (Beállítások → Olvasás),
- a robots.txt hirdeti a térképet, és nem tiltja,
- nincs ütköző SEO- vagy gyorsítótár-bővítmény,
- NGINX-szerveren a rewrite-szabályokra vonatkozó megjegyzés.
A SEOPress PRO SEO Alerts moduljával ez a vizsgálat automatikusan is futhat, és e-mailben vagy Slacken értesít, ha a térkép meghibásodik.
Ne gyorsítótárazd a térképet
Szekció neve “Ne gyorsítótárazd a térképet”Ha nem látod a térképet, vagy a Google Search Console azt írja: „Your file appears to be an HTML page”:
- zárd ki az XML és XSL fájlokat a gyorsítótár-bővítményekből (lásd lent),
- zárd ki őket a Weglot bővítményből és a CDN-ből is,
- frissítsd a Really Simple SSL bővítményt a legújabb kiadásra.
Kizárási szabályok gyorsítótár-bővítményenként
Szekció neve “Kizárási szabályok gyorsítótár-bővítményenként”Az XML-térképet és az XSL stíluslapot soha nem szabad gyorsítótárazni. A legtöbb bővítmény ezt magától megteszi, de nem mind.
| Bővítmény | Teendő |
|---|---|
| WP Rocket | Nincs teendő, teljesen kompatibilis, az előtöltés is működik. |
| Autoptimize | Nincs teendő. |
| WP-Optimize | Nincs teendő. |
| W3 Total Cache | A lenti szabályokat add hozzá: Performance → Page cache → Never cache the following pages, Performance → Minify → Never minify the following pages, Performance → Database cache → Never cache the following pages, Performance → Browser cache → 404 error exception list. |
| Hummingbird | A szabályokat a Hummingbird → Caching oldal Exclusions részébe írd. |
| WP Super Cache | A szabályokat a Settings → WP Super Cache → Advanced részbe írd. |
| Swift Performance | Tools → Swift Performance → Settings → Caching → General: a Cache sitemap legyen kikapcsolva. |
| LiteSpeed Cache | LiteSpeed Cache → Cache → Excludes fül, Do Not Cache URIs mező. |
A szabályok (soronként egy):
[a-z0-9_\-]*[a-z0-9_\-]*\.(xml|xsl|html)(\.gz)?([a-z0-9_\-]*?)([a-z0-9_\-]*)?\.xmlMentsd a beállítást, és ürítsd a gyorsítótárat.
Divi témánál ütközés lehet a Google-betűtípusok betöltésének javításával: kapcsold ki a Improve Google Fonts loading beállítást a Divi Theme Options → General → Performance részén.
404-es hiba
Szekció neve “404-es hiba”Az XML-térkép bekapcsolásakor vagy a térképbeállítások módosításakor a permalinkeket (az URL-átírást) frissíteni kell. A SEOPress ezt mentéskor magától megteszi, de ha mégis 404-et kapsz:
- Nyisd meg a Beállítások → Közvetlen hivatkozások oldalt. A frissítéshez nem kell menteni, a megnyitás is elég.
- Ellenőrizd, hogy a térképet nem gyorsítótárazza semmi (a legtöbb gyorsítótár-bővítmény magától kizárja).
- Ellenőrizd, hogy a karbantartási mód (például egy bővítményből) ki van kapcsolva.
Ha TranslatePress-t használsz, a SEO-csomagot tartalmazó fizetős változatot telepítsd. NGINX-en a rewrite-szabályokat a szerver konfigurációjába kell felvenni, ebben kérd a tárhelyszolgáltatód segítségét.
„Couldn’t fetch sitemaps” a Google Search Console-ban
Szekció neve “„Couldn’t fetch sitemaps” a Google Search Console-ban”- Győződj meg róla, hogy az XML-térkép be van kapcsolva, a böngészőben megnyitva nem ad 404-et vagy üres oldalt, és érvényes XML.
- Csak a fő (index) térképet küldd be, az al-térképeket nem kell külön: a Google megtalálja őket.
- Ha a hiba marad, próbáld URL-átírás nélküli címmel:
https://example.com/index.php?seopress_sitemap=1. Beküldés után frissítsd az oldalt (F5), néha ez segít, hogy az adatok megjelenjenek. - A Google akár hetekig is tarthat, mire beolvassa vagy frissíti a térkép adatait: légy türelmes.
Google Search Console hibák a képtérképnél
Szekció neve “Google Search Console hibák a képtérképnél”- Tiltsd le a shortcode-ok futtatását a képtérképekben egy horoggal (a gyermektéma
functions.phpfájlján át). - Vagy kapcsold ki az Enable XML Image Sitemap beállítást a SEO → XML - HTML Sitemap → General fülön.
Üres térkép
Szekció neve “Üres térkép”- XSL-hiba: a térképhez tartozó stíluslap nem töltődik be, vagy a téma vagy egy bővítmény módosította. A stíluslap címe:
https://example.com/sitemaps_xsl.xsl; a forráskódja általában gyorsan elárulja a hibát. - WP Debug: ha az index és/vagy az al-térképek forráskódja is üres, kapcsold be a
WP_DEBUGnaplózást; a térkép újratöltése után a hiba adebug.logfájlban lesz.
Hiányzik egy URL a térképből
Szekció neve “Hiányzik egy URL a térképből”Ellenőrizd, hogy nem jelölted noindexre. Az az URL is kimarad, amelynek egyéni kanonikus címe eltér a permalinkjétől.
„Extra kód” a térkép forrásában
Szekció neve “„Extra kód” a térkép forrásában”A SEOPress 9.0 óta a shortcode-ok alapból tiltottak. Ha harmadik féltől származó PHP- vagy JS-kód látszik, tiltsd le a shortcode-ok futtatását a térképekben egy kódrészlettel (gyermektéma functions.php, vagy must-use bővítmény, ha nincs ilyen fájl, például Oxygen buildernél).
Lassú térkép
Szekció neve “Lassú térkép”Kapcsold ki a képtérképet (Enable XML Image Sitemap) a General fülön.
„XML declaration allowed only at the start of the document”
Szekció neve “„XML declaration allowed only at the start of the document””A térkép forrásának első sora üres. Ezt általában egy rosszul nyitott vagy zárt <?php címke okozza. Nézd át a téma header.php és functions.php fájlját, és a wp-config.php fájlt.
Időtúllépés az index térkép betöltésekor
Szekció neve “Időtúllépés az index térkép betöltésekor”Az indexlekérdezést egy kódrészlettel 10 ezer bejegyzésre korlátozhatod (gyermektéma functions.php vagy mu-plugins).
Ha semmi nem segít
Szekció neve “Ha semmi nem segít”A PRO-felhasználók a vevői fiókjukból nyithatnak támogatási jegyet, az ingyenes bővítmény használói a wordpress.org fórumán írhatnak.
Készült: