构建公开页面
了解如何构建在用户之间共享数据的公开"静态"页面,例如着陆页、列表页(产品、博客等)、营销和新闻网站。
公开页面向每个用户展示相同的内容。常见示例包括着陆页、营销页面和产品页面。
由于数据是共享的,这类页面可以提前预渲染并复用。这带来更快的页面加载速度和更低的服务端成本。
本指南将向你展示如何构建在用户之间共享数据的公开页面。
示例#
作为示例,我们将构建一个产品列表页面。
我们将从一个静态头部开始,添加一个包含异步外部数据的产品列表,并学习如何在不阻塞响应的情况下渲染它。最后,我们将添加一个针对特定用户的促销横幅,而无需将整个页面切换为动态渲染。
你可以在此处找到本示例中使用的资源:
第 1 步:添加一个简单的头部#
让我们从一个简单的头部开始。
// 静态组件
function Header() {
return <h1>Shop</h1>
}
export default async function Page() {
return (
<>
<Header />
</>
)
}静态组件#
<Header /> 组件不依赖于任何在请求之间会变化的输入,例如:外部数据、请求头、路由参数、当前时间或随机值。
小知识:如果需要显示与区域设置相关的日期或时间且不出现可见闪烁,请参阅防止水合前闪烁。
由于其输出永不变化且可以提前确定,这类组件称为静态组件。由于没有理由等待请求,Next.js 可以在构建时安全地预渲染该页面。
我们可以通过运行 next build 来确认这一点。
Route (app) Revalidate Expire
┌ ○ /products 15m 1y
└ ○ /_not-found
○ (Static) 预渲染为静态内容请注意,尽管我们没有添加任何显式配置,产品路由仍被标记为静态。
第 2 步:添加产品列表#
现在,让我们获取并渲染产品列表。
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' 指令将函数标记为可缓存。
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,可以确认页面仍然是静态的:
Route (app) Revalidate Expire
┌ ○ /products 15m 1y
└ ○ /_not-found
○ (Static) 预渲染为静态内容但是,页面很少永远保持静态。
第 3 步:添加动态促销横幅#
迟早,即使是简单的页面也需要一些动态内容。为了演示这一点,让我们添加一个促销横幅:
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。
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 来确认:
Route (app) Revalidate Expire
┌ ◐ /products 15m 1y
└ ◐ /_not-found
◐ (Partial Prerender) 预渲染为静态 HTML,并包含服务端流式传输的动态内容在构建时,页面的大部分内容(包括头部、产品列表和促销后备 UI)会被渲染、缓存并推送到内容分发网络。
在请求时,预渲染部分会从离用户较近的 CDN 节点即时提供。
与此同时,针对特定用户的促销内容在服务端渲染,流式传输到客户端,并替换到后备位置。
如果最后一次刷新页面,可以看到页面的大部分内容即时加载,而动态部分则在可用时流式传入。
下一步#
我们已经学习了如何构建主要静态、同时包含少量动态内容的页面。
我们从一个静态页面开始,添加了异步工作,并通过缓存可预渲染的内容、流式传输不可预渲染的内容来解决阻塞问题。接下来,你可以: