파싱할 수 없는 구조화된 데이터 해결 방법

파싱되지 않는 JSON-LD 블록은 Google에게 보이지 않습니다. 그 안의 상품, 평점, 탐색경로가 다른 보고서에서 빠지므로, 유효한 항목이 갑자기 줄어든 이유가 이 보고서에 있을 수 있습니다.

메시지별 뜻

Google 도움말은 이 보고서의 모든 항목이 심각한 구조화된 데이터 오류라고 말합니다. 하나의 오류가 여러 페이지에 영향을 주면 가장 흔한 원인은 템플릿 오류입니다.

파싱 오류: ',' 또는 '}' 누락: 두 필드 사이에 쉼표가 없거나 중괄호가 닫히지 않았습니다.
파싱 오류: ':' 누락: 필드 이름 뒤에 콜론이 없습니다.
파싱 오류: '}' 또는 개체 구성 요소 이름 누락: 필드 이름이 와야 할 자리입니다. 닫는 중괄호 앞의 남은 쉼표가 원인일 수 있습니다.
파싱 오류: 배열 선언에 ',' 또는 ']' 누락: 목록에 쉼표가 없거나 닫히지 않았습니다.
문자열의 이스케이프 시퀀스가 잘못됨: \'처럼 JSON이 허용하지 않는 백슬래시가 있습니다.
잘못된 최상위 요소: 블록의 가장 바깥이 JSON 객체나 목록이 아닙니다.
고유 속성 중복: 한 번만 나와야 하는 속성이 두 번 나옵니다.
잘못된 JSON 문서: Google이 블록을 JSON으로 전혀 읽지 못했습니다.

잘못된 숫자, 잘린 유니코드 문자 같은 메시지도 있습니다. 행을 클릭하면 페이지와 오류 세부정보가 나옵니다.

JSON-LD를 가장 자주 깨뜨리는 것

손으로 고친 경우. Shopify 포럼의 한 스토어는 main-product.liquid에 hasMerchantReturnPolicy와 shippingDetails를 넣다가 다음 필드 앞의 쉼표를 빠뜨렸습니다. 그 템플릿은 모든 상품 페이지에 쓰이므로 쉼표 하나가 전부를 깨뜨립니다.
그대로 붙여 넣은 글자. 12인치를 뜻하는 12"처럼 큰따옴표가 들어간 상품명은 문자열을 일찍 끝냅니다. Shopify Liquid에서는 {{ product.title | json }}처럼 json 필터로 값을 써서 따옴표를 이스케이프하세요.
마지막 필드 뒤의 쉼표. JavaScript는 허용하지만 JSON은 허용하지 않습니다.
스크립트 태그 하나에 블록 두 개. 목록으로 감싸거나 태그를 하나씩 주세요.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Cast Iron Skillet 12\" Pre-Seasoned",
  "image": "https://example.com/photos/skillet.jpg"
}
</script>

깨진 줄 찾기

보고서의 예시 페이지를 여세요. 소스를 보고 application/ld+json을 찾으세요.
블록을 리치 결과 테스트나 Schema Markup Validator에 붙여 넣으세요. 둘 다 오류가 있는 줄을 가리킵니다.
그래도 모르겠다면 Google 도움말은 빈 객체에서 시작해 깨질 때까지 코드를 조금씩 다시 넣어 보라고 권합니다.
페이지 하나가 아니라 블록을 쓰는 템플릿, 플러그인 설정, 앱을 고치세요. 한 번 고치면 그것을 쓰는 모든 페이지가 고쳐집니다.

블록이 파싱되면 Google이 안의 내용을 읽을 수 있습니다. 그러면 문법 오류가 가리던 새 경고가 판매자 등록정보나 다른 보고서에 나타날 수 있습니다.

확인하기

모든 페이지를 고쳤다면 문제에서 수정 결과 확인을 누르세요. Google은 확인에 보통 최대 2주쯤 걸리고 더 오래 걸릴 수도 있다고 말합니다.

CrawlCoach가 하는 일

유료 요금제에서 CrawlCoach는 Google에 있는 내 페이지의 HTML을 읽고 모든 JSON-LD 블록이 파싱되는지 확인합니다. 파싱되지 않는 블록은 페이지와 해결 단계와 함께 수정 목록에 들어가고, CrawlCoach가 실제 페이지를 다시 확인해 수정을 확인합니다. 한 템플릿에서 읽은 모든 페이지가 같은 오류라면 템플릿 수정 하나로 묶어 드립니다.

자주 묻는 질문

파싱할 수 없는 구조화된 데이터 때문에 페이지가 색인되지 않나요?

아닙니다. Google은 깨진 블록을 무시합니다. 페이지는 색인되어 일반 결과로 나올 수 있습니다. 그 블록이 줬을 리치 결과만 잃습니다.

문법 오류를 고쳤는데 왜 새 경고가 나오나요?

이제 Google이 마크업을 읽을 수 있어서 입력란을 확인하기 때문입니다. Google 도움말은 파싱 오류를 고치면 숨겨져 있던 경고나 오류가 나타날 수 있다고 말합니다.

수정 결과 확인은 얼마나 걸리나요?

Google 도움말은 보통 최대 2주쯤 걸리고 더 오래 걸릴 수도 있다고 말합니다.

출처

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

파싱할 수 없는 구조화된 데이터: 깨진 JSON-LD 찾아 고치기