Next.js表單狀態一直顯示送出中:用pending提示與重試
訪客按送出,按鈕變成「送出中」,等了很久卻無法再按。先看請求是不是還在等待,還是已經回錯誤而畫面沒解除狀態。兩種原因的修法不同;把按鈕重新打開,只解決了表面操作,還要讓訪客知道這次送出到底到了哪一步。 以下用 Next.js 16、React 19 的 App Router 表單作例子。Client Component 以 useActionState 處理表單 action,再向自己的 Next Route Handler 發 POST;這不是 Server Action,也沒有連接正式資料庫、寄信或付款。 把等待、錯誤與完成分開顯示 等待時顯示「送出中,請稍候」,暫時停用這個送出按鈕。取得可用錯誤回應後,等待應結束,保留輸入,說明原因並提供重試;成功時則按接收端真正回傳的結果顯示,不要只因請求有回應就寫「已寄送」。 按鈕原本就因缺資料而停用,屬於送出前的條件。可先看停用按鈕旁怎麼說明原因。這篇處理的是已送出後的等待生命週期,不把欄位格式合格當成伺服器已接收。 讓第一次失敗,再用同一段文字重試 示例 Route Handler 先檢查訊息,再等待約 1.8 秒;第一個有效嘗試回 503,第二個回 200。故障次序是為了重現操作安排的,嘗試次數只控制示例,不是正式提交身分或防重複機制。 真實 Next.js 示例正在等待自己的 POST 回應;文字仍在輸入框。 第一次取得 503 後,畫面解除等待,按鈕改為「重試」,訊息仍是剛才的文字。按重試會再發一個 POST;第二次取得 200 後,示例顯示「請求已成功回應;未保存或寄送資料」。它只確認這個示例端點完成回應。 服務回錯誤後,等待結束,保留輸入並提供重試。 讓 pending 跟著真實非同步工作 在 Client Component 檔案開頭加入 'use client',從 React 匯入 useActionState 與 useState。useActionState 的 action 接收上一份 state 與這次 FormData,回傳下一份結果;不要把第一個參數誤當表單資料。 這個 action 讀取示例端點約定的 JSON message,並用 HTTP 狀態決定成功或錯誤。片段中的 /api/submit 必須有自己實際建立的 Route Handler,接收 POST JSON 並回相應狀態及 message;貼上前端函式不會自動建立接收端。...
Next.js重新整理和站內切換結果不同:找出讀取狀態的位置
Next.js 列表切換後,網址已經是 ?q=shop,搜尋標題卻還寫 blog;按一下瀏覽器重新整理,標題又正常了。這種差異不一定是快取,也不一定是 Link 壞掉。先找出畫面讀的是目前網址,還是元件第一次建立時留下的值。 這裡用 App Router 的搜尋條件作例子。站內 Link 的基本選擇可先讀Next.js 站內連結用 Link 還是 a;本文接著處理「連結已正確切換,但畫面狀態沒跟上」的問題。 先決定哪個值應該跟著網址走 搜尋結果、分類與頁碼通常需要能直接開啟、分享,也要在重新整理後保持同一條件。若你的列表把 q 定義為搜尋條件,就讓結果與顯示的已套用條件讀同一個網址參數。別讓網址是一份資料,元件又保留另一份互不更新的副本。 輸入框裡尚未送出的文字則不同。訪客正在把「部落格」改成「部落格模板」,不代表結果已經套用新條件。可以用本地 state 保存草稿,按送出後才更新網址。這樣畫面能分清「正在編輯」與「已套用」,也不會因每打一個字就換頁而打斷操作。 先在紙上列出三項:網址裡的 q、結果實際使用的 q、輸入框草稿。若前兩項不一致,就查讀取流程;若只有草稿不同,先確認它是否本來就應保留。不要為了讓所有數字一致,直接清掉訪客還沒送出的內容。 最容易漏看的,是 useState 的初始值 下面兩行看起來都在讀 q,生命週期卻不同: const q = useSearchParams().get('q') ?? ''; const [initialQ] = useState(q); q 來自這次渲染取得的網址參數;initialQ 是 state 第一次初始化時的值。React 不會因下一次傳給 useState 的初始參數改了,就自動覆寫既有 state。若元件仍保留著,切換到 shop 時,q 可以是 shop,initialQ 卻仍是 blog。 這不表示元件完全沒有重新渲染。它可能已經讀到新 q,只是畫面仍選擇顯示 initialQ。排查時把兩個值暫時並排顯示,通常比單看「畫面沒動」更容易定位。若目前 q 已更新,就先查用了哪個變數,不必急著清除整站快取。 同一個共用 layout,三種操作的差異 以下以 Next.js 16 的 App Router 搜尋示例說明。首頁與模板列表共用 layout,裡面的 Client Component 同時顯示目前 q、初始化快照及草稿。由 /?q=blog 填入「部落格模板」,再點原分頁的 Link 前往 /products?q=shop。...
