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.