路由區段配置

如果啟用了 dynamicIO 標誌，本頁概述的選項將會停用，並最終在未來被棄用。

路由區段選項允許您透過直接匯出以下變數來設定頁面、版面配置或路由處理器的行為

選項

experimental_ppr

為版面配置或頁面啟用部分預先渲染 (PPR)。

export const experimental_ppr = true
// true | false

dynamic

將版面配置或頁面的動態行為變更為完全靜態或完全動態。

export const dynamic = 'auto'
// 'auto' | 'force-dynamic' | 'error' | 'force-static'

小提示：`app` 目錄中的新模型傾向於在 fetch 請求層級進行細緻的快取控制，而不是 `pages` 目錄中頁面層級的 getServerSideProps 和 getStaticProps 的二元全有或全無模型。`dynamic` 選項是一種為了方便起見選擇回到先前模型的方式，並提供更簡單的遷移路徑。

• 'auto' (預設)：預設選項，盡可能快取，而不會阻止任何元件選擇加入動態行為。

• 'force-dynamic'：強制動態渲染，這將導致路由在請求時為每個使用者渲染。此選項等同於

  • 將版面配置或頁面中每個 fetch() 請求的選項設定為 { cache: 'no-store', next: { revalidate: 0 } }。
  • 將區段設定設定為 export const fetchCache = 'force-no-store'

• 'error'：強制靜態渲染並快取版面配置或頁面的資料，方法是當任何元件使用動態 API 或未快取的資料時引發錯誤。此選項等同於

  • `pages` 目錄中的 getStaticProps()。
  • 將版面配置或頁面中每個 fetch() 請求的選項設定為 { cache: 'force-cache' }。
  • 將區段設定設定為 fetchCache = 'only-cache', dynamicParams = false。
  • dynamic = 'error' 會將 dynamicParams 的預設值從 true 變更為 false。您可以透過手動設定 dynamicParams = true，選擇重新動態渲染非由 generateStaticParams 產生的動態參數頁面。

• 'force-static'：強制靜態渲染並快取版面配置或頁面的資料，方法是強制 cookies、headers() 和 useSearchParams() 傳回空值。

小提示:

• 關於如何從 getServerSideProps 和 getStaticProps 遷移到 dynamic: 'force-dynamic' 和 dynamic: 'error' 的說明，請參閱升級指南。

dynamicParams

控制當訪問未使用 generateStaticParams 產生的動態區段時會發生什麼情況。

export const dynamicParams = true // true | false,

• true (預設)：未包含在 generateStaticParams 中的動態區段會依需求產生。
• false：未包含在 generateStaticParams 中的動態區段將傳回 404。

小提示:

• 此選項取代了 pages 目錄中 getStaticPaths 的 fallback: true | false | blocking 選項。
• 若要在首次訪問時靜態渲染所有路徑，您需要返回 generateStaticParams 中的空陣列，或使用 export const dynamic = 'force-static'。
• 當 dynamicParams = true 時，區段會使用串流伺服器渲染。
• 如果使用 dynamic = 'error' 和 dynamic = 'force-static'，則會將 dynamicParams 的預設值變更為 false。

revalidate

設定版面配置或頁面的預設重新驗證時間。此選項不會覆寫由個別 fetch 請求設定的 revalidate 值。

export const revalidate = false
// false | 0 | number

• false (預設)：預設啟發式方法，用於快取任何將其 cache 選項設定為 'force-cache' 或在動態 API 使用之前發現的 fetch 請求。語義上等同於 revalidate: Infinity，這實際上表示資源應無限期快取。個別 fetch 請求仍然可以使用 cache: 'no-store' 或 revalidate: 0 來避免被快取並使路由動態渲染。或者將 revalidate 設定為小於路由預設值的正數，以增加路由的重新驗證頻率。
• 0：確保版面配置或頁面始終動態渲染，即使沒有發現動態 API 或未快取的資料取得。此選項會將未設定 cache 選項的 fetch 請求的預設值變更為 'no-store'，但保持選擇加入 'force-cache' 或使用正 revalidate 的 fetch 請求不變。
• number：(以秒為單位) 將版面配置或頁面的預設重新驗證頻率設定為 n 秒。

小提示:

• revalidate 值需要是靜態可分析的。例如，revalidate = 600 是有效的，但 revalidate = 60 * 10 則不是。
• 當使用 runtime = 'edge' 時，revalidate 值不可用。
• 在開發模式中，頁面始終依需求渲染，且永不快取。這可讓您立即看到變更，而無需等待重新驗證期間過去。

重新驗證頻率

• 單一路線的每個版面配置和頁面中最低的 revalidate 值將決定整個路線的重新驗證頻率。這確保子頁面與其父版面配置一樣頻繁地重新驗證。
• 個別 fetch 請求可以設定低於路由預設 revalidate 的值，以增加整個路由的重新驗證頻率。這可讓您根據某些條件動態選擇加入更頻繁的特定路由重新驗證。

fetchCache

export const fetchCache = 'auto'
// 'auto' | 'default-cache' | 'only-cache'
// 'force-cache' | 'force-no-store' | 'default-no-store' | 'only-no-store'

export const runtime = 'nodejs'
// 'nodejs' | 'edge'

export const preferredRegion = 'auto'
// 'auto' | 'global' | 'home' | ['iad1', 'sfo1']

export const maxDuration = 5