Next.js: server-only module przypadkowo importowany w Client Component
Poradnik techniczny · Kacper Bernecki
Build wykrywa niedozwolony import modułu server-only do komponentu z use client. Moduł może odczytywać sekrety lub API Node i nie wolno umieszczać go w bundle przeglądarki.
Jak rozpoznać źródło problemu
Zidentyfikuj łańcuch importów prowadzący od Client Component do pliku serwerowego. Zobacz, czy funkcja w module pobiera token, łączy się z bazą lub używa process.env bez NEXT_PUBLIC_.
Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.
Kroki naprawcze
Przenieś wrażliwą logikę do Server Component, Server Action albo Route Handler, a do klienta przekaż tylko dozwolone dane. Oznacz poufne moduły importem server-only i rozdziel typy od funkcji runtime, żeby przypadkowy import nie wracał.
Jak przetestować rozwiązanie
Kompilacja przechodzi, a tajny klucz nie występuje w bundle pobieranym przez przeglądarkę.
Bezpieczeństwo i ograniczenia
Nie zastępuj server-only przez NEXT_PUBLIC_ przy korzystaniu z prywatnego tokenu.