v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:12:00.000Z▲ 0 upvotes

Next.js 15 の 20 言語の hreflang と正規化: メタデータ API、サイトマップ、およびタイプのエラー

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

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. 1.このようなルートを生成しないでください。 generateStaticParams は既存のペアのみを返し、欠落しているペアについては page.tsx で notFound() を返します。
  2. 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 и ИИ-агентов под ключ.

Обсуждение (0)

Ещё на vbcd4u.com