사이트맵 XML 오류: 구문분석 오류, XML 태그 없음 등

어디에 나오나요?

색인생성 > Sitemaps에서 사이트맵 세부정보 페이지의 '사이트맵을 읽을 수 있지만 오류가 있음' 아래에 나옵니다. 오류를 펼치면 줄 번호가 보입니다.

흔한 원인

• 주소 안의 이스케이프되지 않은 특수 문자: &는 &로 써야 합니다. 따옴표와 < >도 이스케이프해야 합니다.
• 테마나 플러그인이 <?xml 앞에 공백, 빈 줄, PHP 알림을 출력합니다.
• 네임스페이스가 틀렸습니다. 예를 들어 0.9를 .9로 썼습니다.
• 직접 만든 파일에 워드프로세서의 둥근 따옴표가 있거나 태그가 중복됐습니다.
• 파일이 UTF-8로 저장되지 않았습니다. Google은 사이트맵에 UTF-8을 요구합니다.

원인 확인하기

1. Search Console에서 오류를 펼쳐 줄 번호를 적으세요.
2. 브라우저에서 사이트맵을 열고 페이지 소스를 보세요. 첫 글자가 <?xml인지 확인하세요.
3. XML 검사기로 파일을 돌려 정확한 줄을 찾으세요.

메시지별 뜻과 해결

• 구문분석 오류: Google이 XML을 파싱하지 못했습니다. 대개 주소에 이스케이프되지 않은 문자가 있습니다. 모든 값에서 &, ', ", <, >를 이스케이프하세요. 예를 들어 &는 &로 씁니다.
• 잘못된 XML: 태그가 너무 많음: <url> 하나에 <loc> 두 개처럼 태그가 중복됐습니다. Search Console이 짚은 중복 태그를 지우고 다시 제출하세요.
• XML 태그 없음: 항목에 필수 태그가 없습니다. 모든 <url>과 색인의 모든 <sitemap>에 <loc>를 넣으세요.
• XML 속성 없음: 태그에 필수 속성이 없습니다. 속성을 넣고 다시 제출하세요.
• 잘못된 태그값: 사이트맵 유형이 허용하지 않는 값입니다. 일반, 색인, 이미지, 동영상, 뉴스 중 내 유형의 규칙과 비교하세요.
• 잘못된 속성 값: 허용되지 않는 속성 값입니다. 오타를 확인하고 허용된 값만 쓰세요.
• 지원되지 않는 형식: 헤더나 네임스페이스가 틀렸거나 속성에 둥근 따옴표를 썼습니다. 파일을 <?xml version="1.0" encoding="UTF-8"?>로 시작하고 곧은 따옴표를 쓰세요.
• 잘못된 네임스페이스: 루트 요소의 네임스페이스가 없거나 틀렸습니다. <urlset>이나 <sitemapindex>에 xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"를 쓰세요.
• 공백으로 시작: XML 선언 앞에 공백이나 빈 줄이 있습니다. Google은 그래도 사이트맵을 읽습니다. 파일이 <?xml로 시작하게 공백을 지우세요.

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://www.example.com/products?id=1&amp;color=blue</loc>
  </url>
</urlset>

고치는 방법

1. Search Console이 짚은 줄이나 그 줄을 만드는 설정을 고치세요.
2. <?xml 앞에 글자가 있다면 플러그인을 하나씩 꺼서 출력하는 플러그인을 찾으세요.
3. 네임스페이스는 http://www.sitemaps.org/schemas/sitemap/0.9를 쓰세요.
4. 파일을 UTF-8로 저장하거나 만드세요.
5. 사이트맵을 다시 제출하세요.

공백으로 시작은 Google이 사이트맵을 읽는 것을 막지 않습니다. 할 수 있을 때 고치되 급하지 않습니다. WordPress에서는 <?xml 앞의 글자가 대개 테마의 functions.php나 플러그인에서 나옵니다. 플러그인을 하나씩 끄거나 잠시 기본 테마로 바꾸고 사이트맵을 다시 여세요.

CrawlCoach가 하는 일

유료 요금제의 CrawlCoach는 매일 사이트맵을 내려받고 Search Console의 사이트맵 데이터를 읽습니다. 플러그인 업데이트 뒤 XML이 깨져 오류가 보고되면, 그 수정이 단계와 함께 수정 목록에 들어갑니다.

자주 묻는 질문

출처

2026년 10월 8일에 확인했습니다. Google은 Search Console과 도움말을 가끔 바꿉니다. 화면이 다르게 보이면 출처를 확인하세요.

• Search Console 도움말: 사이트맵 보고서를 사용하여 사이트맵 관리하기
• Google 검색 센터: 사이트맵 제작 및 제출하기
• Rank Math: Configure sitemaps(영어)