Kategoria: Next.js, React i TypeScript

Next.js: Event handlers cannot be passed to Client Component props

Poradnik techniczny · Kacper Bernecki

Podczas renderowania pojawia się błąd o przekazaniu onClick z Server Component do komponentu klienta. Funkcje obsługi zdarzeń przeglądarki muszą istnieć w kontekście klienckim; nie można serializować dowolnego callbacku przez granicę serwer–klient.

Jak ustalić źródło błędu

Znajdź komponent z przekazanym onClick, onChange lub funkcją w obiekcie props.

Sprawdź położenie dyrektywy use client i czy importowany komponent faktycznie jest granicą kliencką.

Co zrobić krok po kroku

1. Przenieś interaktywny przycisk i handler do małego Client Component, zachowując pobieranie danych po stronie serwera.

2. Przekazuj do klienta jedynie serializowalne dane i identyfikatory niezbędne do zdarzenia.

Jak sprawdzić wynik

Build kończy się bez błędu serializacji, a kliknięcie nadal wywołuje oczekiwane działanie.

Czego nie robić

Nie dodawaj use client do całego layoutu tylko dlatego, że jeden przycisk ma onClick.