Lista kontrolna SEO w Next.js (App Router)
Lista kontrolna SEO w Next.js dla App Router, z kodem | We.Inc
Lista SEO dla App Router: metadata i generateMetadata, metadataBase, szablony tytułów, canonical, hreflang, sitemap.ts, robots.ts i obrazy OG, z kodem.
Lista kontrolna SEO w Next.js (App Router)
W App Router tagi SEO pochodzą z eksportowanego obiektu metadata lub funkcji generateMetadata w plikach layout i page, które działają tylko w Server Components. Ustaw metadataBase raz w głównym layoucie, dodaj app/sitemap.ts i app/robots.ts, nadaj każdej trasie canonical przez alternates i umieść plik opengraph-image obok stron, które go potrzebują.
Gdzie znajduje się każdy element
- Potrzeba
- Plik lub pole w App Router
- Tytuł i opis
- export const metadata lub generateMetadata w page.tsx albo layout.tsx
- Bazowy URL dla linków względnych
- metadataBase w app/layout.tsx
- Canonical i hreflang
- alternates.canonical i alternates.languages
- app/sitemap.ts zwracający MetadataRoute.Sitemap
- app/robots.ts zwracający MetadataRoute.Robots
- Obraz do udostępniania
- opengraph-image.png, .jpg, .gif lub .tsx w folderze trasy
App Router ma wbudowane rozwiązania niemal każdego technicznego zadania SEO, ale są one rozrzucone po kilkunastu stronach dokumentacji. Ta lista zbiera je w kolejności, z kodem do skopiowania dla każdego punktu, a pola wyboru pozwalają śledzić postępy we własnym projekcie.
- Przechodź po liście i zaznaczaj każdy punkt, gdy jest gotowy. Zaznaczenia zostają tylko w tej karcie.
- Najpierw skopiuj kod głównego layoutu, bo metadataBase i szablon tytułu wpływają na wszystkie pozostałe trasy.
- Dodaj pliki sitemap i robots, a potem otwórz /sitemap.xml i /robots.txt na serwerze deweloperskim, aby przeczytać wynik.
- Wyświetl źródło kilku tras, aby potwierdzić, że tytuł, canonical i tagi og są w HTML.
- Obiekty metadata scalają się płytko. Jeśli strona ustawia openGraph, zastępuje cały obiekt openGraph z layoutu, więc rozwijaj wspólne pola ze wspólnego pliku.
- title.template w layoucie dotyczy segmentów potomnych, a nie własnej strony layoutu, i wymaga obok siebie title.default.
- Użycie względnego adresu URL w polu metadata bez metadataBase powoduje błąd builda, co jest przydatnym wczesnym ostrzeżeniem.
- Zostaw page.tsx jako Server Component, aby dało się eksportować metadata, a hooki i obsługę zdarzeń przenieś do osobnego pliku komponentu klienckiego.
Najczęściej zadawane pytania
Czy mogę użyć generateMetadata w komponencie klienckim?
Nie. Obiekt metadata i generateMetadata są obsługiwane tylko w Server Components, bo Next.js musi je rozwiązać na serwerze przed renderowaniem. Zostaw stronę jako Server Component i zaimportuj komponent kliencki dla części interaktywnych.
Dlaczego params w generateMetadata jest obiektem Promise?
Obecne wersje Next.js przekazują params i searchParams jako obiekty Promise, więc wewnątrz asynchronicznej generateMetadata piszesz const { slug } = await params. Kod napisany dla starszych wersji, który odczytuje params.slug bezpośrednio, wymaga aktualizacji.
Jak w Next.js zrobić mapę witryny z ponad 50,000 adresów URL?
Użyj generateSitemaps w pliku sitemap.ts. Zwraca ona listę identyfikatorów, a domyślny eksport buduje jedną mapę witryny na każdy identyfikator. W Next.js 16 identyfikator przychodzi jako Promise. Pliki są serwowane pod ścieżkami takimi jak /product/sitemap/1.xml.
Czy Next.js automatycznie dodaje tag canonical?
Nie, chyba że go ustawisz. Dodaj alternates.canonical w metadata każdej trasy, zwykle jako ścieżkę względną, na przykład /blog/my-post, i pozwól metadataBase zamienić ją w pełny URL.
Czy mogę eksportować jednocześnie metadata i generateMetadata?
Nie, segment trasy może eksportować jedno albo drugie. Używaj statycznego obiektu, gdy nic nie zależy od żądania ani pobranych danych, a generateMetadata, gdy zależy.
Najpierw statycznie, dynamicznie tam, gdzie trzeba
- Większość stron marketingowych może korzystać ze statycznego obiektu metadata. Po generateMetadata sięgaj w trasach dynamicznych, takich jak /blog/[slug] lub /products/[id], gdzie tytuł pochodzi z danych.
- Wywołania fetch wewnątrz generateMetadata są memoizowane razem z tym samym żądaniem na stronie, więc wczytanie wpisu dla metadata i ponownie do renderowania nie podwaja pracy.
Renderowanie nadal ma znaczenie
- Server Components wysyłają prawdziwy HTML, a to właśnie on jest najpierw czytany przez roboty i narzędzia do podglądu linków. Treść pojawiająca się dopiero po pobraniu po stronie klienta jest odkrywana wolniej i niewidoczna dla aplikacji, które nie uruchamiają JavaScriptu.
- Od wersji 15.2 metadata z generateMetadata mogą być strumieniowane po pierwszym HTML dla przeglądarek. Dla botów, które nie potrafią uruchomić JavaScriptu, takich jak facebookexternalhit, Next.js nadal umieszcza tagi w sekcji head, rozpoznając je po user agencie.
Kod dla każdego punktu
Główny layout: metadataBase, szablon tytułu, wartości domyślne
Ustawiane raz w app/layout.tsx. Strony potomne eksportujące title: "Pricing" wyświetlają się jako Pricing | Northside.
Trasa dynamiczna: generateMetadata z canonical
Na params czekamy przez await. getPost oznacza Twoją własną funkcję pobierającą dane.
app/sitemap.ts
Zwraca jeden wpis na każdy URL. changeFrequency i priority są opcjonalne i Google je ignoruje, więc zostały pominięte.
app/robots.ts
Generuje robots.txt w katalogu głównym strony.
app/blog/[slug]/opengraph-image.tsx
Rysuje obraz do udostępniania 1200 na 630 z tytułu wpisu za pomocą ImageResponse z next/og. Eksporty alt, size i contentType stają się tagami og.
Limity plików graficznych
Obrazy do udostępniania oparte na plikach
- Plik
- Typy
- Limit rozmiaru
- .jpg, .jpeg, .png, .gif or .js, .ts, .tsx
- 8 MB (powyżej build się nie udaje)
- .jpg, .jpeg, .png, .gif or .js, .ts, .tsx
- 5 MB (powyżej build się nie udaje)
- .txt
- Staje się og:image:alt
metadataBase ustawione w app/layout.tsx
Pozwala, by każde inne pole URL było ścieżką względną
Szablon tytułu i wartość domyślna w głównym layoucie
Daje każdej stronie spójną końcówkę, na przykład | Acme
Unikalny tytuł i opis na każdej stronie
Statyczne metadata lub generateMetadata dla każdej trasy
Canonical na każdej indeksowanej trasie
hreflang dla przetłumaczonych tras
alternates.languages albo w mapie witryny
app/sitemap.ts wymienia tylko działające adresy canonical
Przy dużej liczbie podziel za pomocą generateSitemaps
app/robots.ts z linią sitemap
Blokuje tylko obszary takie jak /admin lub /api
Obraz Open Graph dla kluczowych tras
Plik opengraph-image z tekstem alternatywnym
noindex na ubogich lub prywatnych trasach
robots: { index: false } w metadata tej trasy
Treść renderowana na serwerze
Sprawdź źródło strony, a nie tylko widok w przeglądarce
Lista kontrolna
Gotowe: {count} z {total}
Zbuduj stronę za darmo · Za darmo, bez karty
Powiązane: Poradniki
- Next.js vs Node.js
- Next.js vs React
- Nginx 502 Bad Gateway i cztery inne częste błędy nginx
- Load balancing w nginx
- Kreator agentów AI no-code
- Tag noindex
- Klucz API Notion
- Ściągawka komend npm
Produkt
Dla kogo
- Dla agencji
- Dla freelancerów
- Dla firm hostingowych
- Dla platform SaaS
- Dla startupów
- Usługi finansowe
- Rozwiązania dla ochrony zdrowia
Funkcje
Zasoby
- Blog
- Centrum pomocy
- Darmowe narzędzia dla firm
- Free UI Components
- Szablony
- Kolekcje szablonów
- Przykłady stron
- Poradniki
- Porównania
- Alternatywy
- Najlepsze
- Recenzje
- Przewodniki po cenach
- Zastosowania
- Słownik i poradniki
- Integracje
- Dla programistów
- Benchmark
- Windows App