구조·마크업 · 공식 문서
리치 결과 테스트 오류와 경고 읽는 법, 고치는 순서
오류는 서치 콘솔이 심각한 문제로 분류하는 것으로, 하나라도 있으면 그 항목은 리치 결과로 나올 수 없습니다. 경고는 중요하지 않은 문제라 고치지 않아도 자격은 남으므로, 문법 오류, 오류, 경고 순서로 고칩니다.
리치 결과 테스트를 돌리면 오류와 경고가 섞여 나옵니다. 둘 다 고쳐야 하는지, 경고만 남으면 괜찮은지가 가장 많이 막히는 자리입니다.
구글 도움말은 둘을 리치 결과 자격으로 가릅니다. 그 기준과 고치는 순서, 배포 뒤 서치 콘솔에서 확인하는 법을 원문으로 정리했습니다.
발견 01
오류는 리치 결과 자격을 막고, 경고는 자격을 남긴 채 표시만 덜 채웁니다
A valid item is an item that doesn’t have any critical issues and can appear on Google as a rich result. An invalid item has at least one critical issue preventing it from appearing as a rich result.
유효한 항목은 심각한 문제가 없어 구글에 리치 결과로 나올 수 있는 항목이다. 잘못된 항목은 심각한 문제가 하나 이상 있어 리치 결과로 나올 수 없다.
| 테스트 표시 | 서치 콘솔 보고서 | 리치 결과 자격 | 할 일 | 공식 문서 원문 |
|---|---|---|---|---|
| 오류 | 심각한 문제(「항목이 무효인 이유」 표) | 리치 결과로 나올 수 없음 | 먼저 고칩니다 | Why items are invalid: Shows critical issues affecting items on your site. These issues prevent your structured data from being used by Google.항목이 무효인 이유 표는 사이트 항목에 영향을 주는 심각한 문제를 보여 준다. 이 문제가 있으면 구글이 구조화 데이터를 쓰지 못한다. |
| 경고 | 중요하지 않은 문제(「항목 표시 개선」 표) | 리치 결과로 나올 수 있음 | 정확한 값이 있으면 채웁니다 | Improve item appearance: Shows non-critical issues affecting structured data on your site.항목 표시 개선 표는 사이트 구조화 데이터에 영향을 주는 중요하지 않은 문제를 보여 준다. |
| 항목 | 공식 문서 원문 |
|---|---|
| 경고는 고쳐야 하나 | Validate your code using the Rich Results Test and fix any critical errors. Consider also fixing any non-critical issues that may be flagged in the tool, as they can help improve the quality of your structured data (however, this isn't necessary to be eligible for rich results).리치 결과 테스트로 코드를 검사해 심각한 오류를 고친다. 도구가 표시한 중요하지 않은 문제도 구조화 데이터 품질을 높이는 데 도움이 되니 고쳐 볼 만하지만, 리치 결과 자격에 꼭 필요하지는 않다. |
| 결과 화면에서 | If there are errors or warnings, expand the individual item to see details, and click the description to open the code explorer in the corresponding location. The explorer uses the rendered source code.오류나 경고가 있으면 항목을 펼쳐 세부정보를 보고, 설명을 누르면 해당 위치의 코드 탐색기가 열린다. 탐색기는 렌더링된 소스 코드를 쓴다. |
| 감지된 항목 칸 | Any items found, whether good, with warnings or errors, or unparseable, will be listed here, along with a description of the item and any issues.찾은 항목은 양호, 경고, 오류, 파싱 불가 여부와 상관없이 여기에 항목 설명, 문제와 함께 모두 나열된다. |
| 리소스 경고 | If a test cannot load all the resources used by a page, you will see a warning.테스트가 페이지에서 쓰는 리소스를 모두 불러오지 못하면 경고가 표시된다. |
경고를 없애려고 화면에 없는 값을 채우면 오히려 가이드라인 위반이 됩니다. 마크업은 화면에 보이는 내용만 담아야 하기 때문입니다.
그래서 경고는 「값이 있는데 안 넣은 것」만 채웁니다. 별점이 없는 상품에 별점 경고가 떠도 그대로 둡니다.
발견 02
문법 오류 17가지는 유형을 판별하기 전에 파서를 멈추므로 가장 먼저 고칩니다
Certain errors can halt the parser before it can even determine the rich result type. If you have such an error, you will get a section labeled "Syntax errors in items of unknown type".
일부 오류는 리치 결과 유형을 판별하기 전에 파서를 멈춘다. 그런 오류가 있으면 「알 수 없는 유형의 항목에 문법 오류가 있음」 섹션이 나온다.
| 순서 | 문법 오류(한국어판 표기) |
|---|---|
| 1 | 잘못된 JSON 문서 |
| 2 | 잘못된 값 유형 |
| 3 | 파싱 오류: ':' 누락 |
| 4 | 파싱 오류: ',' 또는 '}' 누락 |
| 5 | 파싱 오류: '}' 또는 개체 구성 요소 이름 누락 |
| 6 | 파싱 오류: 배열 선언에 ',' 또는 ']' 누락 |
| 7 | 토큰 길이를 파싱할 수 없음 |
| 8 | 잘못된 숫자 |
| 9 | 문자열의 이스케이프 시퀀스가 비어 있음 |
| 10 | 문자열의 이스케이프 시퀀스가 잘못됨 |
| 11 | 잘린 유니코드 문자 |
| 12 | 잘못된 유니코드 문자 |
| 13 | 잘못된 유니코드 이스케이프 시퀀스: 4진수 필요 |
| 14 | 잘못된 유니코드 이스케이프 시퀀스: 16진수 필요 |
| 15 | 고유 속성 중복 |
| 16 | Invalid top level element |
| 17 | 존재하지 않는 항목 참조 |
| 자주 보는 오류 메시지(한국어판 표기) | 고치는 법 |
|---|---|
| '속성 이름' 입력란이 누락됨 | 빠진 속성을 넣습니다. 값이 빈 문자열이어도 이 메시지가 나옵니다. |
| '속성 이름' 필드의 객체 유형이 잘못됨 | 그 속성에 문서가 정한 데이터 유형(@type)을 씁니다. |
| datetime 속성('속성 이름')에 시간대가 누락됨 | 날짜·시간 문자열에 +09:00 같은 시간대를 붙입니다. |
| '속성' 필드의 가격 형식이 잘못됨 | 가격은 숫자로, 통화는 priceCurrency 로 나눠 적습니다. |
| '속성 이름' 속성의 열거 값이 잘못됨 | InStock 처럼 문서가 허용한 값 가운데 하나를 씁니다. |
| 알 수 없는 '속성 이름' 필드 | 속성 이름의 철자를 확인합니다. |
| 잘못된 ISO 4217 통화 코드 | 원화는 KRW 처럼 세 글자 통화 코드를 씁니다. |
| 전역 식별자(예: gtin, mpn, isbn)를 제공하지 않음 | gtin8·gtin13·gtin14·mpn·isbn 중 하나 이상을 넣습니다. |
| 잘못되었거나 지원되지 않는 @context 값 | @context 를 https://schema.org 로 씁니다. |
리치 결과 테스트는 구글 리치 결과 유형을 기준으로 검사합니다. 구글 기능이 아닌 schema.org 유형은 스키마 마크업 유효성 검사 도구에서 문법을 확인합니다.
구글 문서의 안내는 "Google recommends that you start with the Rich Results Test to see what Google rich results can be generated for your page. For generic schema validation, use the Schema Markup Validator to test all types of schema.org markup, without Google-specific validation."입니다. 두 도구의 차이는 「구조화 데이터」 편에 자세히 적었습니다.
발견 03
고치는 순서는 6단계이고, 배포 뒤 확인은 2주 이상 걸릴 수 있습니다
| 순서 | 할 일 | 도구 |
|---|---|---|
| 1 | URL 상태와 크롤링 칸을 먼저 봅니다. 「URL을 크롤링할 수 없음」이면 마크업보다 접근 문제부터 풉니다. | 리치 결과 테스트 |
| 2 | 「알 수 없는 유형의 항목에 문법 오류가 있음」이 있으면 JSON 문법부터 고칩니다. 이 오류는 유형 판별 전에 파서를 멈춥니다. | 리치 결과 테스트 |
| 3 | 항목을 펼쳐 오류(심각한 문제)를 고칩니다. 설명을 누르면 코드의 해당 자리가 열립니다. | 리치 결과 테스트 |
| 4 | 경고(중요하지 않은 문제)는 화면에 실제로 있는 값만 채웁니다. 값이 없으면 비워 둡니다. | 리치 결과 테스트 |
| 5 | 구글이 쓰지 않는 schema.org 유형은 스키마 마크업 유효성 검사 도구로 문법만 봅니다. | 스키마 마크업 유효성 검사 도구 |
| 6 | 배포 뒤 리치 결과 보고서에서 문제 하나를 골라 템플릿을 고치고 「수정 결과 확인」을 누릅니다. | 서치 콘솔 리치 결과 보고서 |
| 서치 콘솔에서 | 공식 문서 원문 |
|---|---|
| 문제 하나씩 | Focus on fixing a specific issue across all relevant URLs before addressing others.다른 문제로 넘어가기 전에 문제 하나를 관련된 모든 URL에서 고치는 데 집중한다. |
| 템플릿 오류 | If the issue stems from a template error, fixing the template will resolve all associated pages.문제가 템플릿 오류에서 나왔다면 템플릿을 고치면 관련 페이지가 모두 해결된다. |
| 걸리는 시간 | Validation can take two weeks or more, depending on crawl frequency.검사는 크롤링 빈도에 따라 2주 이상 걸릴 수 있다. |
| 고치는 자리 | The structured data resides on your website, not Google’s servers. Fixes must be applied to your site’s source code to resolve issues permanently.구조화 데이터는 구글 서버가 아니라 사이트에 있다. 문제를 완전히 해결하려면 사이트 소스 코드를 고쳐야 한다. |
| 검사 상태(한국어판 표기) | 다음 할 일 |
|---|---|
| 시작하지 않음 | 고친 뒤 「수정 결과 확인」을 누릅니다 |
| 시작됨 | 진행 알림을 기다립니다 |
| 문제 없음 | 검사가 끝날 때까지 지켜봅니다 |
| 통과 | 추가 조치 없음 |
| 실패함 | 남은 URL을 고치고 다시 시작합니다 |
| 해당 사항 없음 | 추가 조치 없음(검사 없이 해결됨) |
발견 04
같은 오류라도 B2B·B2C·B2G 사이트마다 고치는 자리가 다릅니다
예시 ① 세미나 일정을 올리는 IT 솔루션 기업 사이트(B2B)
행사 마크업에 날짜만 넣고 시간대를 빼면 시간대 누락 오류가 납니다. 한국 시간 행사는 2026-11-12T14:00:00+09:00 처럼 적습니다.
세미나 페이지가 템플릿 하나에서 나온다면 템플릿 한 곳을 고치면 모든 페이지가 함께 고쳐집니다.
예시 ② 원화 가격을 쓰는 쇼핑몰(B2C)
가격 칸에 「39,000원」을 문자열로 넣으면 가격 형식 오류가 납니다. price 는 39000, priceCurrency 는 KRW 로 나눠 적습니다.
별점이 없는 신상품에 별점 경고가 떠도 자격은 남습니다. 리뷰가 실제로 쌓인 뒤에 채웁니다.
예시 ③ 로그인 뒤에 자료를 두는 공공기관 누리집(B2G)
리치 결과 테스트는 로그인하지 않은 사용자로 페이지를 엽니다. 로그인이나 내부망 뒤의 페이지는 크롤링 단계에서 막힙니다.
원문은 "Important: All page resources must be accessible by an anonymous user accessing the code from the internet."입니다. 공개 전 시안은 URL 대신 코드를 붙여 넣어 검사합니다.
그럼 오늘 테스트 결과를 받았다면 어떤 순서로 손대나요?
- URL 상태와 크롤링 칸을 먼저 봅니다. 「URL을 크롤링할 수 없음」이면 마크업보다 접근 문제부터 풉니다.
- 「알 수 없는 유형의 항목에 문법 오류가 있음」이 있으면 JSON 문법부터 고칩니다. 이 오류는 유형 판별 전에 파서를 멈춥니다.
- 항목을 펼쳐 오류(심각한 문제)를 고칩니다. 설명을 누르면 코드의 해당 자리가 열립니다.
- 경고(중요하지 않은 문제)는 화면에 실제로 있는 값만 채웁니다. 값이 없으면 비워 둡니다.
- 구글이 쓰지 않는 schema.org 유형은 스키마 마크업 유효성 검사 도구로 문법만 봅니다.
- 배포 뒤 리치 결과 보고서에서 문제 하나를 골라 템플릿을 고치고 「수정 결과 확인」을 누릅니다.
- 검사 상태가 「통과」가 될 때까지 문제 세부정보 페이지를 지켜봅니다. 끝내 안 나오면 「리치 결과 뜻과 표시 조건」 편의 순서로 다시 봅니다.
조사 방법
- Search Console Help 「Rich Results Test」 · 최종 확인일 2026-10-25 · https://support.google.com/webmasters/answer/7445569
- Search Console Help 「Rich result report overview」 · 최종 확인일 2026-10-25 · https://support.google.com/webmasters/answer/7552505
- Search Console Help 「Fix structured data issues in Search Console」 · 최종 확인일 2026-10-25 · https://support.google.com/webmasters/answer/13300208
- Search Console Help 「Rich result error messages & solutions」 · 최종 확인일 2026-10-25 · https://support.google.com/webmasters/answer/13300873
- Google Search Central 「Product snippet (Product, Review, Offer) structured data」 (문서 수정일 2026-09-08) · 최종 확인일 2026-10-25 · https://developers.google.com/search/docs/appearance/structured-data/product-snippet
- Google Search Central 「Test your structured data」 · 최종 확인일 2026-10-18 · https://developers.google.com/search/docs/appearance/structured-data
- 문법 오류 17가지는 리치 결과 테스트 도움말 「Syntax errors in items of unknown type」 표의 행 수입니다. 검사 상태 6가지는 「Fix structured data issues」 도움말 표의 행 수입니다.
- 고치는 순서 6단계는 위 도움말들이 적은 일을 작업 순서로 묶은 것입니다. 묶는 방식은 편집 판단입니다.
- 예시 ①②③은 이해를 돕기 위해 만든 가상 상황이며, 실제 기업·기관의 사례가 아닙니다.
- 원문은 영어판(hl=en)이고, 도구·보고서·오류 메시지 이름은 같은 문서 한국어판(hl=ko) 표기를 따랐습니다. 문법 오류 한 줄은 영어 원문 이름으로 적었습니다.