快取架構
優先級:P1 (高)
Next.js 有四個不同的快取層。了解它們可以防止過時資料的錯誤。
實作指南
- Next.js 15+ 標準:在 API 呼叫中使用
fetch搭配revalidate: number或cache: 'force-cache'。對於自訂資料儲存,請使用unstable_cache或新的'use cache'(實驗性)。 - 層級:區分 資料快取(跨請求持久化)和 請求記憶化(專屬於 React 生命週期)。使用 React 的
cache()來消除單次渲染中的重複擷取。 - 失效:在資料變更後使用
revalidatePath('/'),或使用revalidateTag('tag-name')進行更精細的快取清除。 - 客戶端快取:了解路由器快取(客戶端記憶體內)及其 30 秒到數分鐘的生命週期。使用
router.refresh()清除它。 - 靜態資源:利用
generateStaticParams在建置時預先渲染靜態路由。使用 ISR(增量靜態再生) 處理定期更新的內容。 - 串流:將
Suspense與fetch觸發條件結合,防止慢速資料阻塞整個頁面的渲染。 - Next.js 16+:在可用情況下,優先使用
'use cache'和cacheLife()而不是revalidate: number,以實現確定性快取。
| 層級 | 位置 | 控制方式 |
|---|---|---|
| 請求記憶化 | 伺服器 | React cache() |
| 資料快取 | 伺服器 | 'use cache', revalidateTag |
| 完整路由快取 | 伺服器 | 靜態預先渲染 |
| 路由器快取 | 客戶端 | router.refresh() |
實作細節
請參閱快取元件與 PPR 以了解詳細的金鑰產生、閉包限制和失效策略。
反模式
- Next.js 16+ 中不使用
unstable_cache:請改用'use cache'指令搭配cacheLife()。 - 不對伺服器資料使用
router.refresh():優先使用revalidateTag()進行目標式快取清除。 - 不在路由層級快取使用者特定資料:使用
'use cache'將個人資料包裹在<Suspense>中。 - 不為沒有標籤的快取設定長時間存活:為標籤分配
cacheTag()以實現細粒度的失效控制。