hreflang i kanoniczny dla 20 języków w Next.js 15: API metadanych, mapa witryny i błędy typów
Dwa różne zadania
canonical i hreflang są często mylone i z tego powodu indeksowanie tłumaczeń jest zepsute.
- kanoniczny mówi: „z grupy identycznych stron ta jest główna”. Tłumaczenia nie są identycznymi stronami.
- hreflang mówi: „ta strona ma wersje w innych językach, oto ich adresy.”
Stąd główna zasada: każda wersja językowa wskazuje na siebie kanoniczną. Jeśli /kk/blog/post ustawi kanoniczny na /en/blog/post, Google uzna wersję kazachską za duplikat wersji angielskiej i nie wyświetli jej w wynikach.
Wymagania dotyczące znaczników
- hreflang wzajemny: jeśli strona A prowadzi do B, to B musi zawierać link do A. Google ignoruje linki niewzajemne.
- Każda strona zawiera się w zestawie.
- Kody - ISO 639-1 dla języka i, jeśli to konieczne, ISO 3166-1 alfa-2 dla regionu oddzielonego łącznikiem:
ru,kk,en,pt-BR. Podkreślenie (pt_BR) nie jest odpowiednie. x-default- strona dla użytkowników, których języka nie ma na liście: zazwyczaj wybór języka lub wersja główna.- Tylko bezwzględne adresy URL i dokładnie te, które zwracają 200 i uważają się za kanoniczne. Link hreflang do adresu z przekierowaniem jest błędem.
Pojedyncze źródło prawdy
Listę lokalizacji i dostępność tłumaczenia dla konkretnej strony należy pobrać z jednego miejsca:
// 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}`;
}wygenerujMetadane
[[VB_1_KOD]]
W Next.js 15 params jest obietnicą, więc await. Ustaw metadataBase w układzie głównym, jeśli używasz ścieżek względnych; tutaj adresy są bezwzględne i są bardziej niezawodne.
Nieprzetłumaczone strony
Najczęstszy problem ze stronami wielojęzycznymi: 5 jest przetłumaczonych na 20 języków, a pozostałe 15 adresów podaje tekst w języku angielskim w ramach /de/, /ja/ i tak dalej. To jest 15 ujęć dla każdego artykułu. Opcje:
- 1.Nie generuj takich tras:
generateStaticParamszwraca tylko istniejące pary, a wpage.tsxdla brakujących -notFound(). - 2.Jeśli trasa musi istnieć (np. ogólny interfejs jest przetłumaczony, ale artykuł nie), podaj stronie
robots: { index: false }i nie umieszczaj go w hreflangu i mapie witryny.
Powyższy kod już to uwzględnia: tylko ustawienia regionalne z translations są uwzględnione w languages.
Mapa witryny z alternatywami
hreflang można również określić w mapie witryny - jest to wygodne, gdy stron jest dużo:
// 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}`)])
),
},
}))
);
}Wybierz jedną metodę - w <head> lub w mapie witryny. Oba są ważne w tym samym czasie, ale jeśli się różnią, otrzymasz sprzeczne sygnały. Przy 20 językach i tysiącach stron weź pod uwagę limit 50 000 adresów URL na plik i podziel mapę witryny przez generateSitemaps.
Diagnostyka
- Search Console → Indeksowanie stron → „Duplikuj, Google wybrał inną stronę kanoniczną” w przypadku tłumaczeń: sprawdź kanoniczny i czy tekst jest rzeczywiście przetłumaczony i nie jest taki sam jak oryginał.
- Wyświetl źródłowy kod HTML, a nie DOM w DevTools:
curl -s https://example.com/kk/blog/post | grep -E 'hreflang|canonical'. Tagi muszą znajdować się w odpowiedzi serwera. - Sprawdź wzajemność za pomocą skryptu: dla każdej strony załaduj wszystkie adresy URL z jej hreflangu i upewnij się, że każdy z nich zawiera linki zwrotne.
- Przekierowania według języka przeglądarki. Jeśli
/automatycznie przekierowuje doAccept-Language, robot (który zwykle nie wysyła tego nagłówka) może nigdy nie zobaczyć niektórych wersji. Oferuj wybór języka, ale nie wymuszaj przekierowań z adresów URL języków.
Ograniczenia
hreflang to wskazówka, a nie dyrektywa: Google może wyświetlić inną wersję, jeśli uzna ją za bardziej odpowiednią. Yandex obsługuje hreflang, ale dla rosyjskojęzycznych odbiorców powiązanie regionalne w Webmasterze może oznaczać więcej. A jeśli tłumaczenia są wykonane maszynowo i są kiepskiej jakości, odpowiednie znaczniki nie uchronią ich przed niską oceną jakości.
Нужна реализация под ваш проект или аудит архитектуры?
Разрабатываем сайты на Next.js, Telegram-ботов, интеграции с CRM и ИИ-агентов под ключ.