Kategoria: Next.js, React i TypeScript

Next.js sitemap zawiera adresy preview zamiast domeny produkcyjnej

Poradnik techniczny · Kacper Bernecki

Sitemap XML działa, ale jej elementy loc wskazują tymczasową domenę deploya Vercel. Adresy w sitemap zostały zbudowane z niestabilnej zmiennej VERCEL_URL zamiast z publicznej domeny kanonicznej.

Jak rozpoznać źródło problemu

Otwórz produkcyjną sitemap i sprawdź prefiks kilku losowych elementów loc. Porównaj konstrukcję adresów w app/sitemap.ts z domeną canonical ustawioną w metadataBase.

Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.

Kroki naprawcze

Użyj jawnej kanonicznej domeny produkcyjnej w generatorze mapy i zbuduj bezwzględne URL wszystkich ważnych stron. Oddziel mapę środowiska preview od produkcji, jeśli publikujesz podglądy indeksowane tylko na własne potrzeby.

Jak przetestować rozwiązanie

Sitemap zawiera adresy właściwego hosta HTTPS, a ich canonical wskazuje ten sam host.

Bezpieczeństwo i ograniczenia

Nie wpisuj do sitemap każdej krótkotrwałej domeny preview, bo utrudnia to konsolidację URL.