Next.js: window is not defined podczas SSR komponentu
Poradnik techniczny · Kacper Bernecki
Aplikacja działa przy nawigacji klienta, lecz odświeżenie strony kończy się błędem window is not defined. Obiekt window nie istnieje w środowisku renderowania serwerowego; import biblioteki może wykonywać kod natychmiast.
Jak ustalić źródło błędu
Sprawdź, czy odczyt window następuje w górnym zakresie modułu, podczas renderowania lub wewnątrz biblioteki.
Zlokalizuj import, po którym zaczyna się błąd, i sprawdź jego zgodność z SSR.
Co zrobić krok po kroku
1. Przenieś kod wymagający window do useEffect uruchamianego w przeglądarce albo do komponentu ładowanego wyłącznie po stronie klienta.
2. Jeśli biblioteka nie wspiera SSR, rozdziel jej integrację od reszty strony i dodaj bezpieczny widok zastępczy.
Jak sprawdzić wynik
Bezpośrednie otwarcie i odświeżenie strony działa bez błędu; funkcja przeglądarkowa nadal działa po hydracji.
Czego nie robić
Nie używaj typeof window w przypadkowych miejscach, jeśli sam import powoduje wyjątek wcześniej.