Next.js: global CSS import w niewłaściwym komponencie
Poradnik techniczny · Kacper Bernecki
Po dodaniu nowego arkusza pojawia się błąd dotyczący lokalizacji globalnego CSS lub kolejności stylów. Reguły importowania globalnych stylów zależą od Pages Router, App Router i konfiguracji bundlera.
Jak rozpoznać źródło problemu
Sprawdź czy projekt używa katalogu app czy pages i w jakim komponencie pojawia się globalny import. Zidentyfikuj konflikt dwóch globalnych arkuszy oraz kolejność ich ładowania po nawigacji.
Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.
Kroki naprawcze
Przenieś globalne style do właściwego entry point frameworka lub użyj CSS Modules dla pojedynczych komponentów. Jeśli konflikt wynika z kolejności stylów, uprość zależności i ustal spójny punkt importu dla całej witryny.
Jak przetestować rozwiązanie
Build i nawigacja między podstronami nie zgłaszają błędu CSS, a wygląd nie zależy od kolejności wejścia.
Bezpieczeństwo i ograniczenia
Nie zamieniaj wszystkich stylów na !important, bo ukryje to konflikt zamiast go rozwiązać.