hreflang und canonical für 20 Sprachen in Next.js 15: Metadaten-API, Sitemap und Typfehler
Zwei verschiedene Aufgaben
canonical und hreflang werden oft verwechselt, weshalb die Übersetzungsindizierung fehlerhaft ist.
- kanonisch sagt: „Von der Gruppe identischer Seiten ist diese die wichtigste.“ Übersetzungen sind keine identischen Seiten.
- hreflang sagt: „Diese Seite hat Versionen in anderen Sprachen, hier sind ihre Adressen.“
Daher die Hauptregel: Jede Sprachversion verweist kanonisch auf sich selbst. Wenn /kk/blog/post „canonical“ auf „/en/blog/post“ setzt, betrachtet Google die kasachische Version als Duplikat der englischen Version und zeigt sie nicht in den Ergebnissen an.
Markup-Anforderungen
- hreflang reziprok: Wenn Seite A auf B verlinkt, muss B auf A verlinken. Google ignoriert nicht reziproke Links.
- Jede Seite nimmt sich selbst in das Set auf.
- Codes – ISO 639-1 für die Sprache und, falls erforderlich, ISO 3166-1 Alpha-2 für die Region, getrennt durch einen Bindestrich:
ru,kk,en,pt-BR. Unterstrich (pt_BR) ist nicht geeignet. x-default– Seite für Benutzer, deren Sprache nicht in der Liste enthalten ist: normalerweise Sprachauswahl oder Hauptversion.- Nur absolute URLs und genau solche, die 200 zurückgeben und sich als kanonisch betrachten. Der Hreflang-Link zu einer Adresse mit Weiterleitung ist ein Fehler.
Eine einzige Quelle der Wahrheit
Die Liste der Gebietsschemas und die Verfügbarkeit der Übersetzung für eine bestimmte Seite sollten an einem Ort entnommen werden:
// 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}`;
}##Metadaten generieren
// 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,
},
};
}In Next.js 15 ist params ein Versprechen, also await. Legen Sie metadataBase im Stammlayout fest, wenn Sie relative Pfade verwenden; Hier sind die Adressen absolut und es ist zuverlässiger.
Nicht übersetzte Seiten
Das häufigste Problem bei mehrsprachigen Websites: 5 sind für 20 Sprachen übersetzt und die restlichen 15 Adressen bieten englischen Text unter /de/, /ja/ usw. Das sind 15 Takes für jeden Artikel. Optionen:
- 1.Generieren Sie keine solchen Routen:
generateStaticParamsgibt nur vorhandene Paare zurück und inpage.tsxfür fehlende -notFound(). - 2.Wenn die Route vorhanden sein muss (z. B. die allgemeine Schnittstelle ist übersetzt, der Artikel jedoch nicht), stellen Sie die Seite mit
robots: { index: false }bereit und fügen Sie sie nicht in den Hreflang und die Sitemap ein.
Der obige Code berücksichtigt dies bereits: Nur Gebietsschemas aus translations sind in languages enthalten.
Sitemap mit Alternativen
hreflang kann auch in der Sitemap angegeben werden – das ist praktisch, wenn es viele Seiten gibt:
// 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}`)])
),
},
}))
);
}Wählen Sie eine Methode – in <head> oder in der Sitemap. Beide sind gleichzeitig gültig, wenn sie jedoch voneinander abweichen, erhalten Sie widersprüchliche Signale. Berücksichtigen Sie bei 20 Sprachen und Tausenden von Seiten die Grenze von 50.000 URLs pro Datei und teilen Sie die Sitemap über generateSitemaps auf.
Diagnose
- Suchkonsole → Seitenindizierung → „Duplikat, Google hat eine andere kanonische Seite ausgewählt“ bei Übersetzungen: Überprüfen Sie, ob der Text kanonisch ist und ob der Text tatsächlich übersetzt ist und nicht mit dem Original übereinstimmt.
- Zeigen Sie den Quell-HTML an, nicht das DOM in DevTools:
curl -s https://example.com/kk/blog/post | grep -E 'hreflang|canonical'. Die Tags müssen in der Serverantwort enthalten sein. - Überprüfen Sie die Reziprozität mit einem Skript: Laden Sie für jede Seite alle URLs aus ihrem Hreflang und stellen Sie sicher, dass jede von ihnen zurückverlinkt.
- Weiterleitungen nach Browsersprache. Wenn
/automatisch zuAccept-Languageumleitet, sieht der Robot (der diesen Header normalerweise nicht sendet) einige Versionen möglicherweise nie. Bieten Sie eine Sprachauswahl an, aber erzwingen Sie keine Weiterleitungen von Sprach-URLs.
Einschränkungen
hreflang ist ein Hinweis, keine Anweisung: Google zeigt möglicherweise eine andere Version an, wenn es diese für relevanter hält. Yandex unterstützt Hreflang, aber für das russischsprachige Publikum bedeutet die regionale Bindung im Webmaster möglicherweise mehr. Und wenn die Übersetzungen maschinell erstellt wurden und von schlechter Qualität sind, kann eine ordnungsgemäße Auszeichnung sie nicht vor einer schlechten Qualitätsbewertung bewahren.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.