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.