Next.js伺服器頁的按鈕onClick報錯:抽出Client元件
在App Router的page加了一顆有onClick的按鈕,建置卻報事件處理函式不能傳到Client Component。先確認這份page是否仍是預設的Server Component。要在瀏覽器處理點擊與本地互動狀態,應把那一小段放進Client Component,而不是在伺服器頁直接加入一般的事件函式。 修正不一定需要把整頁都加上use client。頁面的資料讀取、文字與其他伺服器工作可以保留原處,只把計數按鈕或其他互動區域抽成客戶端元件。這樣依賴與責任比較清楚,也避免只為一顆按鈕搬動整個資料流程。 這份page預設在伺服器側處理 下面是最小問題寫法。它沒有use client,卻在原生button上帶一般onClick函式。 export default function Page() { return <main> <button onClick={() => console.log('click')}>計數</button> </main> } 函式裡的console.log本身不是重點,換成setState或其他任意click函式也沒有解決元件邊界。問題是伺服器渲染的這段UI,要把一個一般事件處理函式留給瀏覽器,卻沒有合適的Client入口。 本文在Next.js16.3.8與React19.3.0測試此page,next build --webpack在prerender階段失敗,結束碼1,訊息指出事件處理函式不能傳給Client Component props,並建議把需要互動的部分轉成Client元件。這不是單純編輯器警告,而是真建置輸出。 先建立最小Counter客戶端元件 在單獨檔案最前面加 'use client',再使用React的本地狀態與事件。指令要位於匯入之前,讓框架辨認這份檔案是Client邊界入口。 'use client' import { useState } from 'react' export default function Counter() { const [count, setCount] = useState(0) return <button onClick={() => setCount(count + 1)}> Count {count} </button> } Counter自行定義點擊函式,不要求伺服器把一段一般函式傳進來。這個最小例子只改本地計數,沒有呼叫API或保存資料。先讓它正常互動,再接回真正的功能,比一開始把整套訂單操作包進去更容易核對問題。 現在Server page只需匯入並放置Counter。這一份page仍可以保持Server Component。 import Counter from './counter' export default function Page() { return <main> <h1>Server page</h1> <Counter...
