NNext.js 中文网 GitHub

dynamicParams

dynamicParams 路由段配置选项的 API 参考。

dynamicParams 选项让你可以控制当访问一个未通过 generateStaticParams 生成的动态段时会发生什么。

layout.tsx | page.tsx
export const dynamicParams = true // true | false
layout.js | page.js | route.js
export const dynamicParams = true // true | false
  • true(默认值):未包含在 generateStaticParams 中的动态路由段会在请求时生成。
  • false:未包含在 generateStaticParams 中的动态路由段将返回 404。

小知识:

  • 此选项取代了 pages 目录中 getStaticPaths 的 fallback: true | false | blocking 选项。

使用 Cache Components#

当启用 Cache Components 时,dynamicParams 不可用。未被 generateStaticParams 返回的路径会在请求时处理。当请求的资源不存在时,请在页面中调用 notFound() 以渲染 not-found UI。有关流式渲染如何影响 HTTP 状态,请参阅状态码。

Next.js 中文网