NNext.js 中文网 GitHub

客户端数据获取

使用数据获取库在 Client Component 中获取数据,可选择从 Server Component 提供初始数据,并协调服务端与客户端缓存。

许多应用无需客户端数据获取库即可提供响应迅速的交互。如果 Client Component 只需读取一次服务端数据,将 Promise 传递给它并使用 React 的 use() 解包。

这样可以避免为从不在客户端重新验证的数据引入库。有关使用 Server Functions、transitions、optimistic UI 和 pending 反馈的模式,请参阅构建交互式应用。

当 Client Component 需要共享的浏览器缓存时,可使用客户端数据获取库,例如 SWR、TanStack Query 或 Apollo Client。这些库可以跨组件提供聚焦重新验证、定时轮询、请求去重或乐观更新。

选择客户端获取模式#

首先决定初始视图是需要来自服务端的数据,还是可以等待 hydration 之后由浏览器发起请求。客户端数据获取库支持三种常见模式:

模式SWRTanStack Query数据何时可用
内联加载状态useSWRuseQueryhydration 后的浏览器请求
Suspense 加载状态使用 suspense: true 的 useSWRuseSuspenseQueryhydration 后的浏览器请求
由服务端提供<SWRConfig fallback><HydrationBoundary>初始渲染或从服务端流式传输

当每个组件都应渲染自己的加载 UI 时,使用内联加载状态。使用 Suspense 在边界处定义加载 UI,并协调界面的哪些部分一起显示或逐步显示。对于仅限客户端的获取,选择与所需加载体验相匹配的模式。Suspense 负责协调渲染,而数据库和组件结构决定请求何时开始。

对于由浏览器驱动的交互(如自动补全),可以使用任一仅限客户端的模式。初始结果需要等待 hydration 和浏览器请求,对于在交互发生前不需要的数据来说,这通常是合适的权衡。

当服务端知道初始渲染需要什么时,从 Server Component 提供初始数据。该值可以包含在初始渲染中,也可以通过 Suspense 流式传输。数据库在 React Server Component payload 中接收它,并可在浏览器中继续管理它。

使用 Cache Components 缓存服务端数据(可选)#

提供初始数据与在服务端缓存它们是相互独立的选择。当服务端读取或渲染的视图应被复用时,添加 Cache Components。当两者都启用时,有三个缓存层可以保存相关数据:

层存储内容新鲜度控制
Next.js 服务端缓存缓存的数据和 Server Component 输出cacheLife 的 revalidate 和 expire
Next.js 客户端缓存已访问和预取路由的 React Server Component payloadcacheLife 的 stale
客户端数据获取库以 SWR key 或 TanStack query key 存储的浏览器数据该库的重新验证选项和 mutations

Next.js 的预取可以在导航前将某个路由的 React Server Component payload 放入客户端缓存。

各缓存层保持独立的新鲜度策略,无需匹配相同的时长。但缓存标识和 mutation 失效必须在各层之间保持协调。

协调 mutations#

Server Components、数据获取库和 mutations 管理数据流的不同部分:

  • Server Components 提供初始数据,作用域限定在拥有它的 segment。
  • 数据获取库 以共享缓存标识存储浏览器中的值。
  • Mutations 可以立即更新浏览器缓存,并使缓存的服务端数据失效,以便下一次渲染读取到新鲜的值。

乐观更新在写入失败时应恢复之前的浏览器值。如果服务端读取未被缓存,就没有可供失效的服务端 tag。

在 mutation 之后,使提供初始数据的任何缓存服务端读取失效:

方法适用场景下一次服务端读取
updateTag(tag)Server Action 必须让更新立即生效等待新鲜数据
revalidateTag(tag, 'max')更新是被动的,或可接受旧数据重新验证期间提供旧数据
revalidateTag(tag, { expire: 0 })webhook 或外部系统要求立即过期等待新鲜数据

使用 SWR 或 TanStack Query 应用这些模式#

在实时演示 next-spa-patterns demo 及其源代码中查看这两种模式。

Next.js 中文网