크롤링·플랫폼 · 공식 문서
사이트맵 오류, 형식 문제부터 고치는 점검 순서
「오류 발생」은 구글이 파일을 받았지만 읽다가 오류를 만난 상태입니다. XML 문법, 크기·개수 한도, 잘못된 URL, 날짜 형식 순서로 보면 파일 전체를 읽지 못하게 하는 오류부터 고치게 됩니다.
서치 콘솔 사이트맵 보고서의 상태는 성공, 오류 발생, 가져올 수 없음 셋입니다. 「가져올 수 없음」은 파일을 받지 못한 접근 문제이고, 「오류 발생」은 받은 파일의 내용 문제입니다.
내용 문제는 파일을 고치면 풀립니다. 서치 콘솔 도움말의 파싱 오류를 묶음으로 나눠, 먼저 볼 것부터 순서대로 정리했습니다.
발견 01
「오류 발생」은 파일을 받아 일부를 읽은 상태이고, 오류 없는 URL 은 크롤링 대기열에 들어갑니다
Has errors: The sitemap could be fetched, but has one or more errors. Any URLs that could be parsed without errors from the sitemap will be queued for crawling.
오류 발생: 사이트맵을 가져왔지만 오류가 하나 이상 있습니다. 오류 없이 읽힌 URL 은 모두 크롤링 대기열에 들어갑니다.
| 상태(한국어판) | 무엇의 문제 | 원문 |
|---|---|---|
| 오류 발생 | 받은 파일의 내용 | Has errors: The sitemap could be fetched, but has one or more errors. Any URLs that could be parsed without errors from the sitemap will be queued for crawling.오류 발생: 사이트맵을 가져왔지만 오류가 하나 이상 있습니다. 오류 없이 읽힌 URL 은 모두 크롤링 대기열에 들어갑니다. |
| 가져올 수 없음 | 파일에 닿는 접근 | Couldn't fetch: The sitemap could not be fetched for some reason.가져올 수 없음: 어떤 이유로 사이트맵을 가져오지 못했습니다. |
| URL 몇 개의 문제 | 그 URL 만 | Issues affecting individual URLs within a sitemap won't prevent Google from continuing to read the sitemap, as long as the sitemap can be fetched and read in general.사이트맵을 가져와 읽을 수 있으면, URL 몇 개의 문제로 구글이 사이트맵 읽기를 멈추지는 않습니다. |
발견 02
점검은 4묶음 순서로 합니다. 파일 전체를 읽지 못하게 하는 XML 문법이 먼저입니다
| 순서 | 묶음 | 먼저 보는 이유 | 오류 수 |
|---|---|---|---|
| 1 | XML 문법 | 파일을 XML 로 읽지 못하면 그 안의 URL 을 하나도 꺼내지 못합니다 | 6 |
| 2 | 크기·개수 한도 | 한도를 넘으면 파일을 나누고 사이트맵 색인 파일로 묶어야 합니다 | 6 |
| 3 | 잘못된 URL | URL 이 틀리면 그 줄만 빠지고 나머지는 계속 읽힙니다 | 7 |
| 4 | 날짜 형식 | lastmod 가 형식에 맞지 않으면 날짜가 잘못되었다는 오류가 납니다 | 1 |
세부정보 페이지에서 오류 이름을 펼치면 문제가 된 태그와 줄 번호가 보입니다. 그 줄을 파일에서 찾아 고치고, 고친 뒤 사이트맵을 다시 제출합니다.
일시적인 오류는 파일 문제가 아닙니다(원문: Generally, when you receive this error, you do not need to resubmit your sitemap.) 몇 시간이 지나도 남아 있을 때 다시 제출합니다.
발견 03
묶음별 오류는 20가지이고, 이름마다 고치는 자리가 정해져 있습니다
| ① XML 문법 오류 | 고치는 법 | 원문 |
|---|---|---|
| 구문분석 오류 | &·<·> 같은 문자를 엔티티로 바꿉니다 | Google could not parse the sitemap's XML. Often, this problem is caused by an unescaped character in the URL.구글이 사이트맵의 XML 을 해석하지 못했습니다. 흔한 원인은 URL 안에 엔티티로 바꾸지 않은 문자가 있는 경우입니다. |
| 잘못된 XML: 태그가 너무 많음 | 오류에 적힌 줄 번호에서 겹친 태그를 지웁니다 | Your sitemap contains duplicate tags. The error lists the problematic tag and the line number.사이트맵에 같은 태그가 겹쳐 있습니다. 오류에는 문제의 태그와 줄 번호가 나옵니다. |
| XML 태그 없음 | url 마다 loc 를 넣습니다 | One or more entries in your sitemap is missing a required tag.사이트맵 항목 하나 이상에 필수 태그가 빠졌습니다. |
| 지원되지 않는 형식 | 네임스페이스를 0.9 로 적고 곧은 따옴표를 씁니다 | Your sitemap is not in a supported format. The namespace in the header must be "http://www.sitemaps.org/schemas/sitemap/0.9" (not .9). All XML attributes must enclosed in either single quotes (') or double quotes (") and those quotes must be straight, not curly.지원하지 않는 형식입니다. 머리의 네임스페이스는 http://www.sitemaps.org/schemas/sitemap/0.9 여야 하고, XML 속성은 곧은 작은따옴표나 큰따옴표로 감싸야 합니다. |
| 잘못된 네임스페이스 | urlset 과 sitemapindex 의 xmlns 를 고칩니다 | The root element of your sitemap doesn't contain the correct namespace, or the namespace is declared incorrectly, or has a typo or incorrect URL.루트 요소에 올바른 네임스페이스가 없거나, 잘못 선언했거나, 오타나 틀린 URL 이 있습니다. |
| 공백으로 시작 | 첫 줄 앞의 빈칸·빈 줄을 지웁니다 | This error won't prevent Google from processing your sitemap, but you might want to remove the whitespace so that the file adheres to the XML standard and you no longer see this error.이 오류가 있어도 구글은 사이트맵을 처리합니다. 다만 XML 표준에 맞추려면 앞의 공백을 지우는 것이 좋습니다. |
| ② 크기·개수 한도 오류 | 고치는 법 | 원문 |
|---|---|---|
| 사이트맵 파일 크기 오류 | 압축 전 50MB 아래로 나눕니다 | Your sitemap is larger than 50MB when uncompressed.사이트맵이 압축 전 50MB 를 넘습니다. |
| URL이 너무 많음 | 파일마다 URL 50,000개 이하로 나눕니다 | Your sitemap lists more than 50,000 URLs.사이트맵에 URL 이 50,000개 넘게 들어 있습니다. |
| 사이트맵이 너무 많음 | 색인 파일마다 사이트맵 50,000개 이하로 나눕니다 | Your sitemap index file lists more than 50,000 sitemaps.사이트맵 색인 파일에 사이트맵이 50,000개 넘게 들어 있습니다. |
| 잘못된 사이트맵 색인 형식: 중첩된 사이트맵 색인 | 색인 파일 안에는 사이트맵 파일만 둡니다 | A sitemap index file can't list other sitemap index files, only sitemap files.사이트맵 색인 파일에는 다른 색인 파일을 넣을 수 없고 사이트맵 파일만 넣을 수 있습니다. |
| 압축 오류 | gzip 으로 다시 압축해 올립니다 | Recompress your sitemap (using a tool such as gzip), upload it to your site, and resubmit it.gzip 같은 도구로 다시 압축해 사이트에 올리고 다시 제출합니다. |
| 빈 사이트맵 | URL 이 한 줄 이상 들어갔는지 봅니다 | Your sitemap doesn't contain any URLs.사이트맵에 URL 이 하나도 없습니다. |
| ③ URL 오류 | 고치는 법 | 원문 |
|---|---|---|
| 잘못된 URL | 공백·따옴표·잘못된 프로토콜을 고칩니다 | A URL in your sitemap is not valid. Check for any incorrect characters such as spaces or quotes.사이트맵의 URL 이 올바르지 않습니다. 공백이나 따옴표 같은 잘못된 문자가 있는지 봅니다. |
| 허용되지 않는 URL | 사이트맵 위치보다 위쪽 경로나 다른 도메인의 URL 을 뺍니다 | Your sitemap includes some URLs that are at a higher level or different domain than the sitemap file.사이트맵 파일보다 위쪽 경로나 다른 도메인에 있는 URL 이 들어 있습니다. |
| 경로 불일치: www 없음 | URL 의 www 를 사이트맵 위치와 맞춥니다 | Modify your sitemap to remove "www" from all the URLs to match your sitemap location.사이트맵의 모든 URL 에서 www 를 빼 사이트맵 위치와 맞춥니다. |
| 경로 불일치: www 포함 | URL 의 www 를 사이트맵 위치와 맞춥니다 | Modify your sitemap to add "www" to all the URLs to match your sitemap location.사이트맵의 모든 URL 에 www 를 붙여 사이트맵 위치와 맞춥니다. |
| 추적할 수 없는 URL | 상대 URL 과 리디렉션 URL 을 최종 절대 URL 로 바꿉니다 | Google is having problems with relative URLs in your sitemap. We suggest that you replace any redirect URLs in your sitemaps with the URLs that should actually be crawled.사이트맵의 상대 URL 을 구글이 처리하지 못하고 있습니다. 리디렉션 URL 은 실제로 크롤링할 URL 로 바꾸는 것이 좋습니다. |
| 사이트맵 색인 파일의 잘못된 URL: 불완전한 URL | 색인 파일의 loc 를 전체 URL 로 적습니다 | Your sitemap index file doesn't include the full URL for each sitemap file that it lists.사이트맵 색인 파일이 사이트맵 파일마다 전체 URL 을 적지 않았습니다. |
| 사이트맵에 robots.txt에 의해 차단된 URL이 포함되어 있음 | 차단된 URL 을 빼거나 robots.txt 를 고칩니다 | Use the URL Inspection tool to confirm which file is being blocked, and modify your robots.txt file to allow Googlebot to access it.URL 검사 도구로 어떤 파일이 차단됐는지 확인하고, Googlebot 이 접근할 수 있게 robots.txt 를 고칩니다. |
| ④ 날짜 오류 | 고치는 법 | 원문 |
|---|---|---|
| 날짜가 잘못되었습니다. | 2005-02-21 이나 2005-02-21T18:00:15+00:00 형식으로 적습니다 | Dates must use W3C Datetime encoding, although you can omit the time portion. Specifying time is optional (the time defaults to 00:00:00Z), but if you do specify a time, you must also specify a time zone.날짜는 W3C Datetime 형식으로 적고 시간 부분은 빼도 됩니다. 시간은 선택이지만 적는다면 시간대도 적어야 합니다. |
발견 04
B2B·B2C·B2G 는 오류가 생기는 자리가 다릅니다
예시 ① 제품명에 & 가 들어간 부품 제조사 사이트(B2B)
제품 URL 쿼리에 & 가 그대로 들어가 사이트맵 전체가 구문분석 오류로 떴습니다. XML 안에서는 & 를 & 로 적어야 합니다.
사이트맵을 만드는 코드에서 URL 을 엔티티로 바꿔 쓰게 고치고 다시 제출합니다.
예시 ② 상품이 늘어 한도를 넘은 쇼핑몰(B2C)
상품이 늘면서 사이트맵 하나에 URL 50,000개가 넘었습니다. 상품·분류·기획전 사이트맵으로 나누고 색인 파일 하나로 묶습니다.
나눈 파일마다 10MB 아래인지도 봅니다. 그래야 네이버에도 같은 파일을 낼 수 있습니다.
예시 ③ www 를 붙여 옮긴 공공기관 누리집(B2G)
누리집을 www 가 붙은 URL 로 옮겼는데 사이트맵 안 URL 은 www 없이 남았습니다. 경로 불일치 오류가 줄마다 뜹니다.
사이트맵을 새로 만들어 모든 URL 을 www 가 붙은 최종 URL 로 맞추고, lastmod 날짜 형식도 함께 봅니다.
그럼 「오류 발생」이 뜬 사이트맵은 어떤 순서로 고치나요?
- 사이트맵 보고서에서 그 사이트맵 행을 눌러 세부정보 페이지를 열고, 오류 이름과 줄 번호를 적어 둡니다.
- XML 문법부터 봅니다. 첫 줄이 XML 선언인지, 네임스페이스가 0.9 인지, & 가 엔티티로 바뀌었는지 확인합니다.
- 파일 크기와 URL 수를 봅니다. 압축 전 50MB·URL 50,000개를 넘으면 나누고 색인 파일로 묶습니다. 네이버에도 낸다면 10MB 아래로 맞춥니다.
- URL 을 봅니다. 절대 URL 인지, 사이트맵과 같은 호스트·프로토콜인지, 리디렉션 없는 최종 URL 인지 확인합니다.
- lastmod 를 봅니다. 날짜만 적거나, 시간을 적었다면 시간대까지 적었는지 확인합니다.
- 고친 파일을 올리고 사이트맵 보고서에서 다시 제출합니다. 상태가 성공으로 바뀌는지 며칠 뒤 다시 봅니다.
조사 방법
- Search Console Help 「Sitemaps report」 · 최종 확인일 2026-10-25 · https://support.google.com/webmasters/answer/7451001
- Google Search Central 「Build and submit a sitemap」 (문서 수정일 2026-07-08) · 최종 확인일 2026-10-25 · https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap
- sitemaps.org 「Sitemaps XML format」 (문서 수정일 2016-11-21) · 최종 확인일 2026-10-25 · https://www.sitemaps.org/protocol.html
- 네이버 서치어드바이저 「RSS 및 사이트맵 제출」 · 최종 확인일 2026-10-25 · https://searchadvisor.naver.com/guide/request-feed
- 오류 20가지는 「Sitemaps report」의 「Sitemap parsing errors」 절에서 일반 사이트맵에 해당하는 것을 골라 4묶음으로 나눈 것입니다. 동영상·뉴스 사이트맵 전용 오류, HTTP 오류, 일시적인 오류는 표에서 뺐습니다. 묶는 방식과 순서는 편집 판단입니다.
- 구글 도움말은 이 오류 목록이 전부는 아니라고 적었습니다(원문: This list isn't complete, but it's long enough, and it covers most of the errors you might see.)
- 예시 ①②③은 이해를 돕기 위해 만든 가상 상황이며, 실제 기업·기관 사례가 아닙니다.
- 원문은 영어판(hl=en)이고, 상태·오류 이름은 같은 도움말 한국어판(hl=ko) 표기를 따랐습니다. 네이버 문서와 서치 콘솔 도움말은 페이지에 수정일이 없습니다.