Kategoria: Next.js, React i TypeScript

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.