[워드프레스] "'Comment' 객체는 'CreativeWork' 객체 내부에 중첩되어야 합니다" 서치 콘솔 경고 해결 방법 (GeneratePress + Rank Math)

구글 서치 콘솔(Google Search Console)을 확인하다 보면 종종 예상치 못한 경고 메시지를 마주하게 됩니다. 그중에서도 "'Comment' 객체는 'CreativeWork' 객체 내부에 중첩되어야 합니다"라는 노란색 경고 표시는 많은 워드프레스 운영자를 당혹스럽게 만듭니다.

다행히 이 경고는 당장 검색 노출이 누락되는 치명적인 빨간색 '오류'는 아닙니다. 하지만 구글과 네이버 같은 검색엔진이 내 블로그의 구조를 완벽하게 이해하고, 더 나은 검색 결과를 제공(리치 스니펫 등)하도록 만들려면 반드시 짚고 넘어가야 할 SEO 최적화 과제입니다.

오늘은 이 경고가 발생하는 근본적인 원인과, 추가 플러그인 설치 없이 코드 한 줄로 깔끔하게 해결하는 방법을 정리해 보았습니다.

문제의 원인: 테마와 SEO 플러그인의 스키마 충돌

이 문제는 사이트의 구조화된 데이터(Schema Markup, 스키마 마크업)가 꼬였을 때 발생합니다.

검색엔진은 블로그의 '본문 글(CreativeWork 또는 Article)'과 그 글 하단에 달린 '댓글(Comment)'이 서로 하나의 세트로 연결되어 있다고 인식해야 합니다. 그런데 이 둘의 소속이 명확하게 중첩(포함)되지 않고 따로따로 출력되면 구글 봇이 혼란을 겪게 됩니다.

특히 GeneratePress 테마와 Rank Math(또는 Yoast 등) SEO 플러그인을 함께 사용할 때 이 현상이 매우 빈번하게 나타납니다.

GeneratePress 테마: 기본적으로 테마 자체에 구형 방식인 마이크로데이터(Microdata) 스키마가 내장되어 HTML 태그에 직접 출력됩니다.
Rank Math SEO: 최신 방식인 JSON-LD 기반의 깔끔한 스키마 데이터를 독립적으로 생성합니다.

즉, 테마와 플러그인이 각자 스키마를 이중으로 뿜어내면서 데이터 구조가 충돌했고, 이로 인해 '댓글' 데이터가 길을 잃어버린 것입니다.

해결 방법: GeneratePress 기본 스키마 비활성화

원인을 알았으니 해결책은 간단합니다. Rank Math가 최신 스키마를 완벽하게 생성하고 있으므로, GeneratePress 테마에 내장된 구형 스키마 기능을 강제로 꺼주면 됩니다.

무거운 플러그인을 추가로 설치할 필요 없이, 테마(차일드 테마)의 functions.php 파일이나 코드 스니펫 플러그인을 통해 아래의 짧은 PHP 코드를 추가해 줍니다.

// GeneratePress 기본 스키마 비활성화 (Rank Math 충돌 및 서치콘솔 오류 해결)
add_filter( 'generate_schema_type', '__return_false' );

이 코드는 오직 GeneratePress 테마가 자체적으로 만들어내는 스키마 출력만 정확하게 차단합니다. Rank Math가 담당하는 검색엔진 최적화 기능이나 사이트 성능에는 전혀 악영향을 주지 않으니 안심하고 적용하셔도 됩니다.

적용 후 필수 조치: 캐시 삭제

코드를 추가했다고 해서 구글이 즉각적으로 변경 사항을 알아채는 것은 아닙니다. 서버와 브라우저에 남아있는 이전 HTML 찌꺼기를 지워주어야 합니다.

워드프레스 캐시 삭제: 사용 중인 캐시 플러그인(LiteSpeed Cache 등)에서 '모든 캐시 비우기(Purge All)'를 실행합니다.
Cloudflare 캐시 삭제: 클라우드플레어를 통한 CDN 및 보안 설정을 사용 중이시라면, 클라우드플레어 대시보드에 접속하여 [캐시] -> [모든 캐시 제거(Purge Everything)]를 반드시 실행해 주어야 합니다.

해결 여부 확인 (구글 리치 결과 테스트)

캐시를 모두 비웠다면 구글 서치 콘솔에 '수정 요청'을 보내기 전에, 구글 자체 테스트 도구로 확인을 해보는 것이 좋습니다.

구글 리치 검색결과 테스트(https://search.google.com/test/rich-results)에 접속합니다.
서치 콘솔에서 오류가 발생했던 개별 블로그 글의 URL을 입력하고 테스트를 실행합니다.
검사 결과에 '기사(Article)' 항목이 정상적으로 감지되고, 상세 보기에서 노란색이나 빨간색 경고가 사라졌다면 완벽하게 해결된 것입니다.

💡 Tip. 코드가 안전한지 소스 코드로 직접 확인하기
"테마의 스키마를 끄는 코드를 넣었다가, 꼭 필요한 스키마까지 다 꺼져버리면 어떡하지?" 하고 걱정하실 수 있습니다. 블로그 글 페이지에서 Ctrl + U (페이지 소스 보기)를 누른 뒤 Ctrl + F 로 {"@type":"BlogPosting" 을 검색해 보세요. Rank Math가 생성하는 정상적인 기사 스키마가 여전히 잘 출력되고 있다면, 랭크매스는 건드리지 않고 테마의 불필요한 찌꺼기 스키마만 성공적으로 차단된 것입니다!