Kategoria: Next.js, React i TypeScript

Next.js parallel routes: po odświeżeniu modal zamienia się w 404

Poradnik techniczny · Kacper Bernecki

Nawigacja w aplikacji otwiera modal, ale bezpośrednie odświeżenie aktualnego URL pokazuje brak dopasowania równoległej trasy. Parallel routes i intercepting routes mogą wymagać default.tsx dla slotów, które nie pasują podczas pełnego reloadu.

Jak rozpoznać źródło problemu

Sprawdź strukturę katalogów @slot, (.)segment i brakujące pliki default.tsx. Porównaj soft navigation z bezpośrednim wpisaniem URL w nowym oknie, zwłaszcza dla zamykanych modali.

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

Kroki naprawcze

Dodaj przewidziane default.tsx do równoległych slotów i zapewnij osobną pełną stronę dla bezpośredniej nawigacji. Ustal semantykę zamykania modala i historię przeglądarki, by Back nie prowadził do pustego widoku.

Jak przetestować rozwiązanie

Soft navigation pokazuje modal, a reload daje działającą stronę lub świadomy fallback, zamiast przypadkowego 404.

Bezpieczeństwo i ograniczenia

Nie traktuj intercepted route jako jedynej strony dostępnej pod danym URL.