Next.js 15 の 20 言語の hreflang と正規化: メタデータ API、サイトマップ、およびタイプのエラー
2 つの異なるタスク
canonical と hreflang はよく混同されるため、翻訳インデックスが壊れます。
- canonical は、「同一のページのグループのうち、これがメインのページです」と述べています。翻訳は同一のページではありません。
- hreflang は次のように述べています。「このページには他の言語のバージョンがあります。そのアドレスはここにあります。」
したがって、主要なルールは、各言語バージョンがそれ自体を正規化することです。 /kk/blog/post が正規版を /en/blog/post に設定すると、Google はカザフ語版を英語版の複製とみなし、結果に表示しません。
マークアップ要件
- hreflang reciprocal: ページ 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 リンクはエラーです。
唯一の真実の情報源
ロケールのリストと特定のページの翻訳の可用性は、次の 1 か所から取得する必要があります。
// 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 の言語と数千のページがある場合、ファイルあたり 50,000 URL の制限を考慮し、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 и ИИ-агентов под ключ.