首頁·報錯訊息

next · 建置與型別

報錯原文

You're importing a component that needs useState. This React hook only works in a client component.

這是什麼意思

在 App Router 裡每個元件預設都是伺服器元件,而某個伺服器元件 import 了一個使用 useState 這類只在瀏覽器裡才有意義的 hook 的檔案。指示詞就是檔案最頂端的一行 'use client',加上它會把這個檔案以及它 import 的一切都拉進用戶端套件——所以只給真正需要狀態的最小那塊加,而不是整頁加,才是便宜的選擇。反方向上,把結構拆成「用戶端元件把伺服器元件當作 children 接收」,就能把取資料的活留在伺服器。Next.js 13 裡同樣的情形寫作 "It only works in a Client Component but none of its parents are marked with \"use client\""。

怎麼修

這個沒有一行命令能解決。說明裡寫了該看哪裡。

來自
next
建置與型別
10

建置階段的錯誤是工具在執行之前就先拒絕了,所以它們出現的那一刻並不弄壞什麼——但它們問你兩個問題:你要把型別或路徑改成和真實結構一致,還是用一個 as any、一條抑制註解讓那一行過去?也正是在這裡,那些只在你自己機器上成立的事情——大小寫、副檔名、環境變數——第一次顯形。

怎麼讀報錯

  • 從第一行往下讀。越往下越是工具內部的事,起因通常寫在最上面。
  • 有檔名和行號就從那裡查——不是堆疊最上面那一格,而是最上面那條提到你自己寫的檔案的行。
  • 把報錯原文照樣去搜,但先去掉你自己的路徑和變數名,正是那些讓搜尋比對不上。
  • 同一種情況在不同版本裡措辭不同。結果不對頭,就把版本號一起加進查詢。
  • 貼上修法之前,先確認它會丟掉什麼。這裡面有些是不能收回的。

常見問題

Q. “You're importing a component that needs useState. This React hook only works in a client component.” 是什麼意思?

在 App Router 裡每個元件預設都是伺服器元件,而某個伺服器元件 import 了一個使用 useState 這類只在瀏覽器裡才有意義的 hook 的檔案。指示詞就是檔案最頂端的一行 'use client',加上它會把這個檔案以及它 import 的一切都拉進用戶端套件——所以只給真正需要狀態的最小那塊加,而不是整頁加,才是便宜的選擇。反方向上,把結構拆成「用戶端元件把伺服器元件當作 children 接收」,就能把取資料的活留在伺服器。Next.js 13 裡同樣的情形寫作 "It only works in a Client Component but none of its parents are marked with \"use client\""。

Q. 怎麼修?

沒有一行命令能解決。上面的說明寫了該看哪裡。

Q. 這是哪個工具報的?

next。它屬於建置與型別,報錯原文有 16 個詞。

相關報錯