Neova고급 SEO 플랫폼

hreflang 검사: hreflang 태그를 검증하고 오류를 고치는 법

hreflang은 검색엔진에 어떤 언어나 지역 버전의 페이지를 누구에게 보여 줄지 알려 줍니다. 개념은 간단합니다. 구현은 깨지기 쉽습니다. 모든 페이지가 모든 버전을 나열해야 하고, 모든 버전이 다시 그 페이지를 나열해야 하며, 잘못된 코드 하나나 리디렉션되는 URL 하나가 세트 전체를 믿을 수 없게 만들 수 있습니다. hreflang 검사 도구는 이 모든 것을 한 번에 읽습니다.

해외 SEOhreflang 검사2026년 11월 21일 업데이트Neova 팀 작성

hreflang 검사 도구가 하는 일

한 페이지의 hreflang 태그만으로는 알 수 있는 것이 거의 없습니다. 중요한 오류는 페이지끼리 비교해야 드러납니다. A 페이지가 B 페이지를 나열하는데, B 페이지도 A 페이지를 나열할까요? B는 200으로 응답할까요? B는 자기 자신이 canonical일까요? 그래서 URL 하나용 hreflang 검사기는 부분 확인에 유용하고, 사이트 전체의 hreflang 검사 도구는 크롤러입니다.

전체 점검은 모든 페이지의 태그를 읽고, 모든 대상을 따라가며, 세트마다 네 가지 질문에 답합니다.

  1. 모든 코드가 유효한가?
  2. 모든 페이지가 자신과 다른 모든 버전을 나열하는가?
  3. 모든 대상이 링크를 되돌려 주는가?
  4. 모든 대상이 200으로 응답하고, 색인 가능하며, 자기 자신이 canonical인 URL인가?

hreflang 태그의 작동 방식

Google의 페이지의 현지화된 버전 가이드는 hreflang을 선언하는 세 가지 방법을 설명합니다. 세트마다 하나를 고르세요.

방법HTML 페이지PDF와 파일위치
link 태그✓–HTML head
HTTP Link 헤더✓✓서버 응답
XML 사이트맵✓✓사이트맵 파일

1. HTML head의 link 태그

<link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
<link rel="alternate" hreflang="en-gb" href="https://example.com/en-gb/pricing/" />
<link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
<link rel="alternate" hreflang="x-default" href="https://example.com/pricing/" />

같은 네 줄이 x-default 페이지를 포함한 네 페이지 모두에 들어갑니다.

2. HTTP Link 헤더

HTML head가 없는 PDF와 기타 파일에 유용합니다.

Link: <https://example.com/en/guide.pdf>; rel="alternate"; hreflang="en",
      <https://example.com/de/guide.pdf>; rel="alternate"; hreflang="de"

3. XML 사이트맵

<url>
  <loc>https://example.com/en-us/pricing/</loc>
  <xhtml:link rel="alternate" hreflang="en-us" href="https://example.com/en-us/pricing/" />
  <xhtml:link rel="alternate" hreflang="de" href="https://example.com/de/preise/" />
</url>

사이트맵은 urlset 요소에 xhtml 네임스페이스를 선언해야 하고, url 항목마다 전체 세트를 반복합니다. 사이트맵을 쓰면 큰 세트를 페이지 head에서 뺄 수 있지만, 페이지가 바뀔 때 잊기 쉽습니다.

모든 hreflang 세트가 지켜야 할 규칙

  • 자기 참조. Google은 각 버전이 다른 모든 버전과 함께 자기 자신도 나열해야 한다고 말합니다.
  • 반환 링크. A 페이지가 B 페이지를 가리키면 B도 A를 가리켜야 합니다. Google은 두 페이지가 서로를 가리키지 않으면 태그가 무시될 수 있다고 말합니다.
  • 절대 URL. /de/가 아니라 https://example.com/de/.
  • 정상적인 대상. 각 대상은 200으로 응답하고, 색인 가능하며, 자기 자신이 canonical이어야 합니다. 리디렉션, 404, noindex 페이지를 가리키는 태그는 검색엔진이 우회해야 하는 신호입니다.
  • 대응하는 페이지. 독일어 가격 페이지는 프랑스어 홈페이지가 아니라 프랑스어 가격 페이지를 가리켜야 합니다.

코드는 정해진 표준을 따릅니다. Google은 현지화된 버전 가이드에 코드를 나열합니다.

코드Standard예시유효한 예
언어ISO 639-1de, pt✓
언어와 지역ISO 3166-1 Alpha 2de-at, pt-br✓
언어와 문자ISO 15924zh-Hant✓
지역만없음us–
영국UK가 아니라 GBen-uk–
대체예약된 값x-default✓

x-default: 대체 버전

x-default는 세트의 다른 어떤 언어나 지역도 방문자와 맞지 않을 때 보여 줄 페이지를 위한 예약된 값입니다. Google은 언어 선택 페이지와, 언어나 위치에 따라 방문자를 리디렉션하는 페이지에 이를 권합니다.

<link rel="alternate" hreflang="x-default" href="https://example.com/" />

선택 사항이지만 홈페이지와 언어 선택기가 있는 페이지에는 쓰는 것이 좋습니다. 다른 대상과 마찬가지로 x-default URL은 200으로 응답하고, 색인 가능하며, 자기 자신이 canonical이어야 하고, 세트의 모든 페이지가 같은 x-default를 지정해야 합니다. 흔한 실수는 위치에 따라 방문자를 리디렉션하는 URL을 x-default로 지정했는데 그 리디렉션이 오류로 끝나는 것입니다.

가장 흔한 hreflang 오류

오류모습해결 방법
반환 링크 없음de가 en-us를 빠뜨림세트마다 공유 목록 하나
자기 참조 없음페이지가 자신을 빠뜨림자기 URL 추가
잘못된 지역 코드en-uken-gb
언어 없이 지역만hreflang="us"en-us
상대 URL/de/전체 https URL
대상이 리디렉션되거나 오류프랑스어 URL이 301최종 URL
대상이 canonical로 다른 곳을 가리킴매개변수 URLcanonical URL
코드 하나, URL 두 개de로 표시된 페이지 두 개코드마다 URL 하나
head 밖의 태그스크립트가 head를 일찍 끝냄위로 옮기거나 헤더 사용
언어 불일치hreflang fr, html lang en페이지 텍스트에 맞춤

SEO ProCheck의 hreflang과 해외 SEO 구현 가이드에서 각 오류를 더 깊이 다룹니다.

hreflang과 canonical

hreflang과 canonical 태그는 함께 작동하며, 서로를 쉽게 망가뜨립니다. 각 언어 버전은 자기 자신이 canonical이어야 합니다. 독일어 페이지가 영어 페이지를 canonical로 지정하면 독일어 페이지가 중복이라고 검색엔진에 말하는 셈이어서 hreflang과 충돌합니다. canonical은 한 언어 안에서 가리키고, hreflang은 언어를 넘어 가리킵니다.

hreflang 세트의 모든 URL이 canonical 버전인지도 확인하세요. 프로토콜, 호스트, 끝 슬래시가 같아야 합니다. http와 https URL이 섞이거나 슬래시 유무가 섞인 세트는 페이지가 맞더라도 URL이 정확히 일치하지 않아 반환 링크 점검에 실패합니다.

사이트 전체의 hreflang 확인하기

  1. 모든 언어 버전을 크롤링하세요. 언어마다 별도 도메인이나 하위 도메인에 있다면 모두 크롤링에 포함하세요. 그렇지 않으면 반환 링크를 점검할 수 없습니다.
  2. 사용하는 모든 방법에서 hreflang을 읽으세요. HTML head, HTTP Link 헤더, 사이트맵입니다. 두 가지 방법으로 선언한 세트는 서로 어긋날 수 있습니다.
  3. 무엇보다 먼저 코드를 검증하세요. 템플릿이 반복하는 잘못된 코드 하나가 수천 페이지에 영향을 줄 수 있습니다.
  4. 모든 페이지의 반환 링크와 자기 참조를 확인하세요.
  5. 대상 상태를 확인하세요. 각 대상의 상태 코드, 색인 가능 여부, canonical입니다.
  6. 빠진 세트를 찾으세요. 다른 언어에 대응 페이지가 있는데 hreflang이 아예 없는 페이지입니다.
  7. 페이지마다가 아니라 템플릿이나 플러그인 수준에서 고치고, 다시 크롤링하세요.

저희 사이트에서도 이렇게 합니다. neova.app은 15개 언어로 운영됩니다. 2026년 11월 20일 SEO 점검에서 XML 사이트맵에는 URL 1,358개가 있었고, 모든 hreflang 링크가 반환되어 완전히 상호 연결되어 있었습니다. 버전이 15개이므로 페이지마다 자신을 포함해 URL 15개를 나열하고, 그 각각이 다시 그 페이지를 나열해야 합니다. 세트의 모든 태그를 공유 목록 하나에서 생성하면 반환 링크는 저절로 맞춰집니다.

hreflang 세트는 기술 SEO 진단 체크리스트의 12단계입니다. 언어 버전이 방문자를 리디렉션한다면 리디렉션 체인 가이드도 읽어 보세요.

Neova로 hreflang 확인하기

Neova의 글로벌 SEO 카테고리는 각 페이지의 언어 및 지역 버전과 서로를 가리키는지 보여 줍니다. HTML head와 HTTP Link 헤더에서 hreflang을 읽고, 모든 HTML 페이지에 Hreflang Languages와 Hreflang Targets 열을 추가하며, html lang을 hreflang 및 페이지 텍스트와 대조합니다. 점검 항목 일부:

플래그마다 왜 중요한지, 어떻게 고치는지, 출처가 무엇인지 알려 주며, 모든 표는 템플릿을 고칠 개발자를 위해 CSV나 Excel로 내보낼 수 있습니다. Neova는 Free를 포함한 모든 요금제에서 694개 점검을 모두 실행합니다.

Neova
지원 환경
점검 항목694
무료 요금제크롤링당 URL 1,000개
인터페이스 언어15

Mac은 Apple silicon을 뜻하며, 브라우저용은 같은 계정으로 쓰는 Neova Online입니다. 기능, 요금을 보거나 Neova 다운로드를 하세요.

자주 묻는 질문

hreflang 검사 도구란 무엇인가요?

사이트의 hreflang 태그를 읽고 서로 대조하는 도구입니다. 유효한 언어 및 지역 코드, 자기 참조, 반환 링크, x-default, 각 대상이 200으로 응답하고 색인 가능하며 자기 자신이 canonical인지 확인합니다.

hreflang 반환 링크란 무엇인가요?

A 페이지가 B 페이지를 대체 버전으로 나열하면 B 페이지도 A 페이지를 나열해야 합니다. Google은 두 페이지가 서로를 가리키지 않으면 hreflang 태그가 무시될 수 있다고 말합니다.

x-default는 필수인가요?

아니요, 선택 사항입니다. 언어 선택 페이지, 홈페이지, 언어나 위치에 따라 방문자를 리디렉션하는 페이지에 권장되며, 그러면 다른 것이 맞지 않을 때 어떤 버전을 보여 줄지 검색엔진이 알 수 있습니다.

en-uk와 en-gb 중 무엇을 써야 하나요?

en-gb입니다. 지역 부분은 ISO 3166-1 Alpha 2 국가 코드이고, 영국의 코드는 GB입니다. en-uk는 유효한 값이 아닙니다. 비슷한 답변은 SEO ProCheck의 hreflang과 해외 SEO FAQ에 더 있습니다.

어떤 hreflang 방법이 가장 좋나요?

Google에는 세 가지 모두 통합니다. HTML head의 link 태그, HTTP Link 헤더, XML 사이트맵입니다. 세트마다 한 가지 방법을 쓰세요. link 태그는 확인하기 가장 쉽고, 헤더는 PDF에 맞으며, 사이트맵은 큰 세트를 페이지 밖으로 뺄 수 있습니다.

이 글 활용하기

어시스턴트 링크를 열면 이 페이지에 대한 질문이 미리 작성되어 있습니다.

Neova로 사이트를 크롤링하세요Free 요금제는 Mac, Windows, Linux에서 모든 점검을 실행합니다. 신용카드가 필요 없습니다.

계속 읽기