Next.js 15의 20개 언어에 대한 hreflang 및 표준: 메타데이터 API, 사이트맵 및 유형 오류
두 가지 다른 작업
canonical와 hreflang는 혼동되는 경우가 많으며 이로 인해 번역 색인이 깨집니다.
- 표준은 "동일한 페이지 그룹 중 이 페이지가 주요 페이지입니다."라고 말합니다. 번역은 동일한 페이지가 아닙니다.
- hreflang은 "이 페이지에는 다른 언어로 된 버전이 있습니다. 해당 주소는 다음과 같습니다."라고 말합니다.
따라서 주요 규칙은 다음과 같습니다. 각 언어 버전은 자체적으로 표준을 가리킵니다. /kk/blog/post가 표준을 /en/blog/post로 설정하면 Google은 카자흐어 버전을 영어 버전과 중복된 것으로 간주하여 결과에 표시하지 않습니다.
마크업 요구 사항
- hreflang 상호: 페이지 A가 B에 연결되면 B는 A에 연결되어야 합니다. Google은 비가역 링크를 무시합니다.
- 각 페이지는 세트에 포함되어 있습니다.
- 코드 - 언어의 경우 ISO 639-1, 필요한 경우 하이픈으로 구분된 지역의 경우 ISO 3166-1 alpha-2:
ru,kk,en,pt-BR. 밑줄(pt_BR)은 적합하지 않습니다. x-default- 목록에 언어가 없는 사용자를 위한 페이지: 일반적으로 언어 선택 또는 기본 버전.- 절대 URL만, 정확히 200을 반환하고 표준으로 간주되는 URL만 해당됩니다. 리디렉션이 포함된 주소에 대한 hreflang 링크는 오류입니다.
단일 정보 소스
특정 페이지의 로케일 목록과 번역 가능 여부는 한 곳에서 가져와야 합니다.
// lib/i18n/config.ts
export const SITE = "https://example.com";
export const LOCALES = ["ru", "en", "kk", "uz", "tr", "de", "fr", "es", "pt-BR", "it",
"pl", "uk", "ar", "hi", "id", "ja", "ko", "zh", "vi", "th"] as const;
export type Locale = (typeof LOCALES)[number];
export const DEFAULT_LOCALE: Locale = "en";
export function localizedUrl(locale: Locale, path: string) {
return `${SITE}/${locale}${path === "/" ? "" : path}`;
}메타데이터 생성
// app/[locale]/blog/[slug]/page.tsx
import type { Metadata } from "next";
import { LOCALES, type Locale, localizedUrl, DEFAULT_LOCALE } from "@/lib/i18n/config";
import { getPostTranslations } from "@/lib/posts";
export async function generateMetadata({
params,
}: {
params: Promise<{ locale: Locale; slug: string }>;
}): Promise<Metadata> {
const { locale, slug } = await params;
const translations = await getPostTranslations(slug); // только реально переведённые локали
const path = `/blog/${slug}`;
const languages: Record<string, string> = {};
for (const l of LOCALES) {
if (translations.includes(l)) languages[l] = localizedUrl(l, path);
}
if (translations.includes(DEFAULT_LOCALE)) {
languages["x-default"] = localizedUrl(DEFAULT_LOCALE, path);
}
return {
alternates: {
canonical: localizedUrl(locale, path), // сама на себя
languages,
},
};
}Next.js 15에서는 params가 Promise이므로 await입니다. 상대 경로를 사용하는 경우 루트 레이아웃에서 metadataBase를 설정합니다. 여기서 주소는 절대적이며 더 안정적입니다.
번역되지 않은 페이지
다국어 사이트의 가장 일반적인 문제: 5개는 20개 언어로 번역되고 나머지 15개 주소는 /de/, /ja/ 등에 영어 텍스트를 제공합니다. 이는 각 기사당 15개의 테이크입니다. 옵션:
- 1.이러한 경로를 생성하지 마십시오.
generateStaticParams는 기존 쌍만 반환하고page.tsx에서는 누락된 쌍에 대해 -notFound()를 반환합니다. - 2.경로가 있어야 하는 경우(예: 일반 인터페이스는 번역되었지만 기사는 번역되지 않은 경우)
robots: { index: false }를 사용하여 페이지를 제공하고 hreflang 및 사이트맵에는 포함하지 마세요.
위의 코드는 이미 이를 고려하고 있습니다. translations의 로케일만 languages에 포함됩니다.
대안이 포함된 사이트맵
hreflang은 사이트맵에도 지정할 수 있습니다. 이는 페이지가 많을 때 편리합니다.
// app/sitemap.ts
import type { MetadataRoute } from "next";
import { localizedUrl, type Locale } from "@/lib/i18n/config";
import { getAllPostsWithTranslations } from "@/lib/posts";
export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
const posts = await getAllPostsWithTranslations();
return posts.flatMap((post) =>
post.locales.map((locale: Locale) => ({
url: localizedUrl(locale, `/blog/${post.slug}`),
lastModified: post.updatedAt,
alternates: {
languages: Object.fromEntries(
post.locales.map((l: Locale) => [l, localizedUrl(l, `/blog/${post.slug}`)])
),
},
}))
);
}<head> 또는 사이트맵 중 하나의 방법을 선택하세요. 두 가지 모두 동시에 유효하지만 서로 다른 경우 충돌하는 신호를 받게 됩니다. 20개 언어, 수천 페이지로 파일당 URL 50,000개 제한을 고려하여 generateSitemaps를 통해 사이트맵을 나눕니다.
진단
- Search Console → 페이지 색인 생성 → "중복됨, Google이 다른 표준 페이지를 선택했습니다" 번역: 표준을 확인하고 텍스트가 실제로 번역되었으며 원본과 동일하지 않은지 확인하세요.
- DevTools의 DOM이 아닌 소스 HTML을 봅니다:
curl -s https://example.com/kk/blog/post | grep -E 'hreflang|canonical'. 태그는 서버 응답에 있어야 합니다. - 스크립트로 상호성을 확인하세요. 각 페이지에 대해 hreflang에서 모든 URL을 로드하고 각각이 다시 연결되는지 확인하세요.
- 브라우저 언어로 리디렉션됩니다.
/가 자동으로Accept-Language로 리디렉션되는 경우 로봇(일반적으로 이 헤더를 보내지 않음)은 일부 버전을 볼 수 없습니다. 언어 선택을 제공하지만 언어 URL에서 강제로 리디렉션하지 마세요.
제한사항
hreflang은 지시문이 아니라 힌트입니다. Google에서는 관련성이 더 높다고 판단하면 다른 버전을 표시할 수도 있습니다. Yandex는 hreflang을 지원하지만 러시아어를 사용하는 사용자에게는 웹마스터의 지역 바인딩이 더 많은 의미를 가질 수 있습니다. 그리고 번역이 기계로 제작되어 품질이 좋지 않은 경우 적절한 마크업을 적용해도 낮은 품질 등급을 피할 수 없습니다.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.