客户端数据获取
使用数据获取库在 Client Component 中获取数据,可选择从 Server Component 提供初始数据,并协调服务端与客户端缓存。
许多应用无需客户端数据获取库即可提供响应迅速的交互。如果 Client Component 只需读取一次服务端数据,将 Promise 传递给它并使用 React 的 use() 解包。
这样可以避免为从不在客户端重新验证的数据引入库。有关使用 Server Functions、transitions、optimistic UI 和 pending 反馈的模式,请参阅构建交互式应用。
当 Client Component 需要共享的浏览器缓存时,可使用客户端数据获取库,例如 SWR、TanStack Query 或 Apollo Client。这些库可以跨组件提供聚焦重新验证、定时轮询、请求去重或乐观更新。
选择客户端获取模式#
首先决定初始视图是需要来自服务端的数据,还是可以等待 hydration 之后由浏览器发起请求。客户端数据获取库支持三种常见模式:
| 模式 | SWR | TanStack Query | 数据何时可用 |
|---|---|---|---|
| 内联加载状态 | useSWR | useQuery | hydration 后的浏览器请求 |
| Suspense 加载状态 | 使用 suspense: true 的 useSWR | useSuspenseQuery | hydration 后的浏览器请求 |
| 由服务端提供 | <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 payload | cacheLife 的 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 及其源代码中查看这两种模式。