Cara Membetulkan Ralat Peta Laman XML yang Biasa

Hampir semua ralat peta laman XML berpunca daripada sebilangan kecil kesilapan yang sama: namespace yang salah, aksara yang tidak di-escape, URL relatif, tarikh lastmod yang tidak sah, fail yang melebihi had, atau URL peta laman yang mengembalikan halaman ralat. Setiap satunya mempunyai pembetulan yang jelas, dan panduan ini menyenaraikan kesemuanya berserta simptom dan penyelesaiannya.

1. Namespace salah atau tiada

Elemen akar <urlset> mesti mengisytiharkan namespace rasmi dengan tepat, aksara demi aksara:

<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">

Kesilapan taip sekecil mana pun — https berbanding http, garis miring tambahan, atau namespace lama versi 0.84 — menyebabkan penghurai yang tegas menolak keseluruhan fail. Jangan menaip semula namespace ini secara manual; salin terus daripada dokumentasi sitemaps.org. Jika penjana peta laman anda mengeluarkan namespace yang lain, kemas kini penjana itu.

2. Aksara &, <, >, " dan ' tidak di-escape

XML mempunyai lima aksara khas yang mesti ditulis sebagai entiti apabila muncul dalam URL. Punca paling lazim ialah URL dengan parameter pertanyaan: /produk?warna=merah&saiz=xl mesti ditulis dengan &, bukan & mentah. Ampersand mentah menyebabkan ralat sintaks yang menghentikan penghuraian di tengah fail — semua entri selepas titik itu turut hilang. Betulkan pada peringkat penjana: gunakan pustaka XML yang membuat escape secara automatik, dan jangan bina XML dengan penggabungan rentetan.

3. URL relatif atau tanpa skema

Setiap <loc> mesti berupa URL mutlak yang lengkap: https://example.com/halaman/. Laluan relatif seperti /halaman/ dan URL tanpa skema seperti //example.com/halaman/ adalah tidak sah mengikut protokol. Perangkak tidak akan meneka hos atau skema bagi pihak anda. Jika penjana anda mengeluarkan laluan relatif, konfigurasikan URL pangkalan laman (base URL) dalam tetapannya.

4. Format lastmod tidak sah dan tarikh masa hadapan

Medan <lastmod> mesti mengikut format tarikh-masa W3C: 2026-07-16 atau 2026-07-16T09:30:00+00:00. Format tempatan seperti 16/07/2026, cap masa Unix dan rentetan seperti "semalam" semuanya tidak sah. Tarikh pada masa hadapan pula menjejaskan kredibiliti keseluruhan fail: Google hanya menggunakan lastmod apabila ia didapati konsisten dan boleh dipercayai. Punca biasa tarikh masa hadapan ialah zon waktu pelayan yang salah konfigurasi atau templat yang memasukkan masa jana dan bukannya masa suntingan kandungan.

5. Melebihi 50,000 URL atau 50 MB

Satu fail peta laman dihadkan kepada 50,000 URL dan 50 MB tanpa mampatan. Melepasi mana-mana satu had bermakna fail itu tidak sah. Penyelesaiannya ialah memecahkan senarai kepada beberapa fail dan menyenaraikannya dalam satu fail indeks — lihat panduan indeks peta laman kami untuk langkah penuh. Kebanyakan CMS dan penjana moden melakukan pemecahan ini secara automatik, tetapi skrip buatan sendiri sering terlepas pandang.

6. URL peta laman mengembalikan 404, ubah hala atau HTML

URL yang anda hantar kepada enjin carian mesti mengembalikan HTTP 200 dengan kandungan XML. Tiga kegagalan yang paling kerap:

• 404 — fail tidak pernah dijana selepas pemindahan pelayan, atau laluannya berubah.
• Ubah hala — contohnya http ke https atau tanpa www ke www. Perangkak mungkin mengikutinya, tetapi rantaian ubah hala mengundang masalah; hantar URL destinasi akhir secara terus.
• HTML — halaman ralat tersuai yang mengembalikan status 200. Fail kelihatan wujud tetapi kandungannya bukan XML. Semak dengan membuka URL itu dan melihat sumbernya.

7. URL pada hos yang berbeza

URL dalam peta laman mesti berada pada hos yang sama dengan hos yang menyajikan fail itu. Percanggahan www dengan tanpa www, atau http dengan https, dikira sebagai hos berbeza dan entri berkenaan akan diabaikan. Pilih satu bentuk kanonikal untuk keseluruhan laman dan pastikan penjana peta laman menggunakannya secara konsisten.

8. Halaman disekat robots.txt atau ditanda noindex

Peta laman ialah senarai halaman yang anda mahu diindeks. Menyenaraikan URL yang disekat oleh robots.txt atau ditanda noindex menghantar isyarat bercanggah, dan Search Console akan melaporkannya sebagai konflik. Buang URL tersebut daripada peta laman, atau — jika halaman itu sepatutnya diindeks — buang sekatan berkenaan.

9. "Couldn't fetch" dalam Google Search Console

Mesej ini bermaksud Googlebot tidak dapat memuat turun fail langsung. Semak mengikut turutan: adakah URL yang dihantar betul-betul tepat (termasuk https dan www)? Adakah robots.txt menyekat laluan peta laman itu sendiri? Adakah pelayan atau CDN menyekat ejen pengguna Googlebot atau mengembalikan ralat 5xx ketika beban tinggi? Ujian paling pantas ialah mengambil URL itu sendiri dengan alat luar — jika pengesah kami boleh mengambilnya tetapi Google tidak, punca biasanya penyekatan di peringkat firewall atau CDN.

Jadual rujukan: simptom → punca → pembetulan

Susunan kerja yang disyorkan

1. Jalankan fail melalui pengesah peta laman dan betulkan semua ralat sintaks dan protokol dahulu.
2. Betulkan amaran yang menjejaskan kepercayaan: lastmod yang cacat, URL pendua, hos bercampur.
3. Hantar semula dalam Search Console dan pantau laporan halaman untuk isu peringkat URL.

Selepas semuanya hijau, jadikan pengesahan sebahagian daripada rutin keluaran anda supaya ralat baharu ditangkap sebelum enjin carian menemuinya. Panduan amalan terbaik peta laman kami menerangkan rutin penyelenggaraan itu dengan lebih lanjut.