Next.js: po ustawieniu basePath zasoby _ next zwracają 404
Poradnik techniczny · Kacper Bernecki
Aplikacja w podkatalogu /panel otwiera HTML, lecz style i JavaScript są ładowane z nieprawidłowych ścieżek. Konfiguracja basePath i assetPrefix może nie pasować do reverse proxy albo docelowego podkatalogu.
Jak rozpoznać źródło problemu
W Network znajdź brakujące zasoby _next i zapisz ich pełne adresy URL. Porównaj basePath w next.config z regułami proxy i faktyczną ścieżką, pod którą serwowany jest projekt.
Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.
Kroki naprawcze
Ujednolić basePath z proxy oraz popraw odwołania do publicznych zasobów, które nie są automatycznie prefiksowane. Przebuduj projekt po zmianie basePath, gdyż ustawienie jest wbudowywane w kod klienta podczas builda.
Jak przetestować rozwiązanie
HTML, CSS i JS ładują się z tego samego przewidzianego prefixu na produkcji.
Bezpieczeństwo i ograniczenia
Nie próbuj naprawiać każdego zasobu osobnym przekierowaniem, gdy cały prefix jest zły.