StaleTimes (實驗性功能)

警告: staleTimes 設定為實驗性功能。此配置策略未來可能會有所變更。

staleTimes 是一項實驗性功能，允許配置客戶端路由快取 (Client Router Cache) 的 失效週期。

此配置選項自 v14.2.0-canary.53 版本起可用。

您可以透過設定實驗性的 staleTimes 標誌來啟用此功能並提供自定義重新驗證時間：

/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    staleTimes: {
      dynamic: 30,
      static: 180,
    },
  },
}

module.exports = nextConfig

static 和 dynamic 屬性對應於基於不同類型 連結預取 (link prefetching) 的時間週期（以秒為單位）。

• dynamic 屬性用於頁面既非靜態生成也未完全預取的情況（例如 prefetch=）。
  • 預設值: 0 秒（不進行快取）
• static 屬性用於靜態生成的頁面，或當 Link 的 prefetch 屬性設為 true 時，或呼叫 router.prefetch 時。
  • 預設值: 5 分鐘

須知事項:

• 載入邊界 (Loading boundaries) 在此配置定義的 static 週期內被視為可重複使用。
• 這不影響 部分渲染 (partial rendering)，意味著共享佈局不會在每次導航時自動重新獲取，只有變更的頁面區段會更新。
• 這不會改變 前進/後退快取 (back/forward caching) 的行為，以防止佈局偏移並保持瀏覽器滾動位置。

您可以在 此處 了解更多關於客戶端路由快取 (Client Router Cache) 的資訊。

版本歷史