NNext.js 中文网 GitHub

构建公开页面

了解如何构建在用户之间共享数据的公开"静态"页面,例如着陆页、列表页(产品、博客等)、营销和新闻网站。

公开页面向每个用户展示相同的内容。常见示例包括着陆页、营销页面和产品页面。

由于数据是共享的,这类页面可以提前预渲染并复用。这带来更快的页面加载速度和更低的服务端成本。

本指南将向你展示如何构建在用户之间共享数据的公开页面。

示例#

作为示例,我们将构建一个产品列表页面。

我们将从一个静态头部开始,添加一个包含异步外部数据的产品列表,并学习如何在不阻塞响应的情况下渲染它。最后,我们将添加一个针对特定用户的促销横幅,而无需将整个页面切换为动态渲染。

你可以在此处找到本示例中使用的资源:

第 1 步:添加一个简单的头部#

让我们从一个简单的头部开始。

app/products/page.tsx
// 静态组件
function Header() {
  return <h1>Shop</h1>
}

export default async function Page() {
  return (
    <>
      <Header />
    </>
  )
}

静态组件#

<Header /> 组件不依赖于任何在请求之间会变化的输入,例如:外部数据、请求头、路由参数、当前时间或随机值。

小知识:如果需要显示与区域设置相关的日期或时间且不出现可见闪烁,请参阅防止水合前闪烁。

由于其输出永不变化且可以提前确定,这类组件称为静态组件。由于没有理由等待请求,Next.js 可以在构建时安全地预渲染该页面。

我们可以通过运行 next build 来确认这一点。

Terminal
Route (app)      Revalidate  Expire
┌ ○ /products           15m      1y
└ ○ /_not-found

○  (Static)  预渲染为静态内容

请注意,尽管我们没有添加任何显式配置,产品路由仍被标记为静态。

第 2 步:添加产品列表#

现在,让我们获取并渲染产品列表。

app/products/page.tsx
import db from '@/db'
import { List } from '@/app/products/ui'

function Header() {}

// 动态组件
async function ProductList() {
  const products = await db.product.findMany()
  return <List items={products} />
}

export default async function Page() {
  return (
    <>
      <Header />
      <ProductList />
    </>
  )
}

与头部不同,产品列表依赖于外部数据。

动态组件#

由于这些数据可能随时间变化,渲染输出不再保证稳定。这使产品列表成为一个动态组件。

如果没有指导,框架会假定你希望在每次用户请求时获取最新数据。这一设计选择反映了标准 Web 行为,即新的服务端请求会渲染页面。

然而,如果该组件在请求时渲染,获取其数据将延迟整个路由的响应。如果刷新页面,就能看到这种情况。

即使头部是即时渲染的,在产品列表完成获取之前,它也无法发送到浏览器。

为了避免这种性能悬崖,当我们第一次 await 这些未缓存的数据时,Next.js 会显示一条警告:在 <Suspense> 之外访问未缓存数据会阻止路由被预渲染。

此时,我们必须决定如何解除响应阻塞。有两种选择:

  • 缓存该组件,使其变得稳定,并可以与页面其余部分一起预渲染。
  • 流式传输该组件,使其变为非阻塞,页面其余部分无需等待它。

在我们的案例中,产品目录在所有用户之间共享,因此缓存是正确的选择。

Cache Components#

可以使用 'use cache' 指令将函数标记为可缓存。

app/products/page.tsx
import db from '@/db'
import { List } from '@/app/products/ui'

function Header() {}

// Cache Component
async function ProductList() {
  'use cache'
  const products = await db.product.findMany()
  return <List items={products} />
}

export default async function Page() {
  return (
    <>
      <Header />
      <ProductList />
    </>
  )
}

这将把它变成一个 Cache Component。它第一次运行时,我们返回的任何内容都会被缓存并复用。

如果 Cache Component 的输入在请求到达之前就可用,它就可以像静态组件一样被预渲染。

如果再次刷新,可以看到页面即时加载,因为 Cache Component 不会阻塞响应。而且,如果再次运行 next build,可以确认页面仍然是静态的:

Terminal
Route (app)      Revalidate  Expire
┌ ○ /products           15m      1y
└ ○ /_not-found

○  (Static)  预渲染为静态内容

但是,页面很少永远保持静态。

第 3 步:添加动态促销横幅#

迟早,即使是简单的页面也需要一些动态内容。为了演示这一点,让我们添加一个促销横幅:

app/products/page.tsx
import db from '@/db'
import { List, Promotion } from '@/app/products/ui'
import { getPromotion } from '@/app/products/data'

function Header() {}

async function ProductList() {}

// 动态组件
async function PromotionContent() {
  const promotion = await getPromotion()
  return <Promotion data={promotion} />
}

export default async function Page() {
  return (
    <>
      <PromotionContent />
      <Header />
      <ProductList />
    </>
  )
}

同样,它一开始也是动态的。和之前一样,引入阻塞行为会触发 Next.js 警告。

上次,数据是共享的,因此可以缓存。这一次,促销依赖于特定于请求的输入,例如用户的位置和 A/B 测试,因此我们无法通过缓存来规避阻塞行为。

部分预渲染#

添加动态内容并不意味着我们必须退回到完全阻塞的渲染。我们可以通过流式传输来解除响应阻塞。

Next.js 默认支持流式传输。我们可以使用 Suspense 边界告诉框架在何处将流式响应切分为块,以及在内容加载时显示什么后备 UI。

app/products/page.tsx
import { Suspense } from 'react'
import db from '@/db'
import { List, Promotion, PromotionSkeleton } from '@/app/products/ui'
import { getPromotion } from '@/app/products/data'

function Header() {}

async function ProductList() {}

// 动态组件(流式传输)
async function PromotionContent() {
  const promotion = await getPromotion()
  return <Promotion data={promotion} />
}

export default async function Page() {
  return (
    <>
      <Suspense fallback={<PromotionSkeleton />}>
        <PromotionContent />
      </Suspense>
      <Header />
      <ProductList />
    </>
  )
}

后备 UI 与其余静态和缓存内容一起被预渲染。内部组件在其异步工作完成后再流式传入。

通过这一改动,Next.js 可以将可预渲染的工作与请求时的工作分离,路由变为部分预渲染。

同样,我们可以通过运行 next build 来确认:

Terminal
Route (app)      Revalidate  Expire
┌ ◐ /products    15m      1y
└ ◐ /_not-found

◐  (Partial Prerender)  预渲染为静态 HTML,并包含服务端流式传输的动态内容

在构建时,页面的大部分内容(包括头部、产品列表和促销后备 UI)会被渲染、缓存并推送到内容分发网络。

在请求时,预渲染部分会从离用户较近的 CDN 节点即时提供。

与此同时,针对特定用户的促销内容在服务端渲染,流式传输到客户端,并替换到后备位置。

如果最后一次刷新页面,可以看到页面的大部分内容即时加载,而动态部分则在可用时流式传入。

下一步#

我们已经学习了如何构建主要静态、同时包含少量动态内容的页面。

我们从一个静态页面开始,添加了异步工作,并通过缓存可预渲染的内容、流式传输不可预渲染的内容来解决阻塞问题。接下来,你可以:

Next.js 中文网