Kategoria: Next.js, React i TypeScript

Next.js Link: href is required przy renderowaniu listy

Poradnik techniczny · Kacper Bernecki

Lista poradników działa dla części rekordów, ale render jednego elementu z Link kończy się błędem o brakującym href. Dane mogą mieć pusty slug albo funkcja budująca URL otrzymała undefined z opcjonalnego pola.

Jak rozpoznać źródło problemu

Sprawdź wartości href dla każdego elementu zanim zostaną przekazane do komponentu Link. Ustal, czy źródło danych zawiera rekordy robocze bez slugu, których nie należy publikować.

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

Kroki naprawcze

Waliduj slug podczas importu treści i generuj Link wyłącznie dla istniejących, poprawnych adresów. Dla brakujących danych pokaż nieklikalny stan i zapisz błąd walidacji treści w CI zamiast tworzyć /undefined.

Jak przetestować rozwiązanie

Każdy link jest prawidłowy i prowadzi do istniejącego adresu; katalog nie renderuje przypadkowych slugów.

Bezpieczeństwo i ograniczenia

Nie ukrywaj błędu wpisaniem href="#" dla każdego uszkodzonego rekordu.