Kategoria: Next.js, React i TypeScript

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.