跳到内容
简介App Router

App Router

Next.js App Router 引入了一种使用 React 最新功能构建应用程序的新模型,例如服务器组件使用 Suspense 进行流式处理服务器操作

通过创建你的第一个页面开始使用 App Router。

常见问题

如何在布局中访问请求对象?

你被有意地禁止访问原始请求对象。但是,你可以通过仅服务器功能访问 headerscookies。你也可以设置 cookies

布局不会重新渲染。它们可以被缓存和重用,以避免在页面之间导航时进行不必要的计算。通过限制布局访问原始请求,Next.js 可以防止在布局内执行可能缓慢或昂贵的用户代码,这可能会对性能产生负面影响。

这种设计还为不同页面上的布局强制执行一致且可预测的行为,从而简化了开发和调试。

根据你正在构建的 UI 模式,并行路由允许你在同一布局中渲染多个页面,并且页面可以访问路由段以及 URL 查询参数。

如何在页面上访问 URL?

默认情况下,页面是服务器组件。你可以通过给定页面的 params 属性访问路由段,并通过 searchParams 属性访问 URL 查询参数。

如果你正在使用客户端组件,你可以使用 usePathnameuseSelectedLayoutSegmentuseSelectedLayoutSegments 来处理更复杂的路由。

此外,根据你正在构建的 UI 模式,并行路由允许你在同一布局中渲染多个页面,并且页面可以访问路由段以及 URL 查询参数。

如何从服务器组件重定向?

你可以使用 redirect 从页面重定向到相对或绝对 URL。redirect 是临时 (307) 重定向,而 permanentRedirect 是永久 (308) 重定向。当在流式处理 UI 时使用这些函数,它们将插入一个 meta 标签以在客户端发出重定向。

如何使用 App Router 处理身份验证?

以下是一些支持 App Router 的常见身份验证解决方案

如何设置 cookies?

你可以使用 cookies 函数在服务器操作路由处理器中设置 cookies。

由于 HTTP 不允许在流式处理开始后设置 cookies,因此你无法直接从页面或布局设置 cookies。你也可以从 中间件 设置 cookies。

如何构建多租户应用?

如果你正在寻找构建一个为多个租户提供服务的单个 Next.js 应用程序,我们构建了一个示例,展示了我们推荐的架构。

如何使 App Router 缓存失效?

Next.js 中有多个缓存层,因此,有多种方法可以使缓存的不同部分失效。了解更多关于缓存的信息

是否有基于 App Router 构建的综合性开源应用程序?

是的。你可以查看 Next.js CommercePlatforms Starter Kit,这两个都是使用 App Router 的更大的开源示例。

了解更多