升級Next.js後,原本的 cookies().get('theme')提示不是可直接使用的cookie store。先看你呼叫的是next/headers提供的cookies函式。現行API是非同步的,應先await取得store,再讀其中的值。 這個修正處理的是伺服器讀取當次請求cookie的介面,不是把cookie搬到全域變數,也不是在瀏覽器改用localStorage。讀者先用兩份合成Cookie標頭測同一條Route Handler,就能確認它讀的是各自請求帶來的值。 先取得store,再呼叫get 下面是最小的App Router Route Handler。它只讀demo_theme並回JSON,不登入、不寫cookie,也不連資料庫。 import { cookies } from 'next/headers' export async function GET() { const store = await cookies() const theme = store.get('demo_theme')?.value ?? 'none' return Response.json({ theme }) } 將它放在 app/cookie/route.js,GET處理函式要是async,才能在裡面await。先解析cookies這個非同步操作,再對store呼叫get。不要寫成 await cookies().get(...),因為那會在等待之前先嘗試對Promise呼叫get。 也不要忘記取得的是cookie物件,需要讀value。.get()找不到該名稱時可能沒有物件,所以範例採可選鏈與預設字串。這個預設只讓示範結果容易辨認,不是你所有業務功能都應採相同的缺值策略。 舊版同步例子不代表目前介面 官方升級指南說明,Next.js15引入非同步的請求API,包含cookies。舊版文件或片段可能仍用同步寫法;維護站點時先確認package與鎖定版本,再按對應指南改。 本文真案例是Next.js16.3.8、React19.3.0,使用await cookies。不把舊站曾經可同步讀取當作現版可依賴的行為,也不要求每個舊專案只因看到本文就立刻升級。這份教學解決的是目前已使用非同步介面的程式怎麼正確取值。 如果編輯器還是顯示與文件不符的型別,也要核實際安裝版本與匯入來源。另一個套件裡同名的cookies方法,不一定是這個API。先把它來自哪裡讀清楚,避免只在呼叫前後加await卻改錯東西。 同一路徑,兩個請求各帶自己的值 本機測試可以分別送light與dark。這些是合成偏好值,不含帳戶、工作階段或權杖。curl的Cookie標頭讓你直接看到輸入,不需要先操作真會員登入。 curl -H 'Cookie: demo_theme=light' http://127.0.0.1:3000/cookie curl -H 'Cookie: demo_theme=dark' http://127.0.0.1:3000/cookie 本文實際HTTP結果是兩次都回200;第一份JSON的theme是light,第二份是dark。這說明同一個處理函式讀到了當次不同的Cookie標頭,不是把第一次讀到的store留著讓所有請求共用。 這份測試沒有觀察瀏覽器自動送cookie的範圍,也沒有修改正式cookie配置。接回網站後,要再核瀏覽器真正發出的請求是否帶預期名稱與值。手動指定標頭能驗證解析介面,不能取代真瀏覽器的domain、path與發送條件。 cookie是請求資料,不是全域設定 不要在模組最外層提前讀cookies,再把結果當成全站固定偏好。cookie跟當次請求有關,應在合適的伺服器請求上下文裡讀。把某一次的值快取成大家共用,會讓不同使用者的結果混在一起。 如果頁面需要依偏好選擇畫面,可以在Server Component裡await cookies,取得並整理允許值,再傳必要資料給顯示元件。選dark或light等固定集合時,對未知值保留明確的預設,不要把任意cookie字串直接當成設定名稱或資料查詢。 讀到cookie也不表示它可信或能單獨決定授權。本例只是顯示合成theme;真登入與資源權限仍沿既有服務驗證。把這兩種需求分開,能讓取值示例保持簡單,不會把任意客戶端提供的字串當成已核身分。 NextRequest.cookies是另一個入口 Route Handler若使用NextRequest,該請求物件也有自己的cookies介面。它與next/headers的cookies函式不是同一個呼叫方式,不能因為名字相似就交換使用,或對兩者都機械加相同await。 export function GET(request) { const theme = request.cookies.get('demo_theme')?.value ?? 'none'...
2026-10-05 47 0
文尼先生 2026-10-05
顯示驗證碼
沒有帳號?註冊  忘記密碼?