【JS】从 Next.js 看企业级框架的 SSR 支持

Z时代
2024-01-10
分类：技术分享

一.Next.js 简介

面向生产使用的 React 框架（废话）。提供了好些开箱即用的特性，支持静态渲染/服务端渲染混用、支持 TypeScript、支持打包优化、支持按路由预加载等等：

其中，完善的静态渲染/服务端渲染支持让 Next.js 在 React 生态中独树一帜

二.核心特性

【JS】从 Next.js 看企业级框架的 SSR 支持

如果说 Next.js 只做了一件事，那就是预渲染（Pre-rendering）：

具体的，预渲染分为两种方式：

SSG（Static Site Generation）：也叫 Static Generation，在编译时生成静态 HTML

SSR（Server-Side Rendering）：也叫 Server Rendering，用户请求到来时动态生成 HTML

与 SSR 相比，Next.js 更推崇的是 SSG，因为其性能优势更大（静态内容可托管至 CDN，性能提升立竿见影）。因此建议优先考虑 SSG，只在 SSG 无法满足的情况下（比如一些无法在编译时静态生成的个性化内容）才考虑 SSR、CSR

P.S.CSR、SSR 等更多渲染模式，见前端渲染模式的探索

围绕核心的预渲染功能，延伸出了一系列相关支持，如：

路由（文件规范、API）：多页面的基础

页面级预渲染、代码拆分：顺理成章

增量静态生成：针对大量页面的编译时预渲染（即静态生成）策略

按路由预加载：锦上添花

国际化（结合路由）：锦上添花

集成 Serverless 函数：锦上添花

自动 polyfill、自定义head标签：友情赠送

此外，还提供了一些通用场景支持：

开箱即用（0 配置）

TypeScript

CSS module、Sass

Fast Refresh（可靠的 Hot Reload 支持）

用户真实数据收集分析（页面加载性能、体验评分等）

带默认优化的Image组件

三.路由支持

Next.js 提供了两种路由支持，静态路由与动态路由

静态路由

静态路由通过文件规范来约定，pages目录下的js文件都认为是路由（每个静态路由对应一个页面文件），例如：

pages/index.js → / pages/blog/index.js → /blog pages/blog/first-post.js → /blog/first-post pages/dashboard/settings/username.js → /dashboard/settings/username

动态路由

类似的，动态路由也要在pages目录下创建文件，只是文件名有些不同寻常：

pages/blog/[slug].js → /blog/:slug (/blog/hello-world)
pages/[username]/settings.js → /:username/settings (/foo/settings)
pages/post/[...all].js → /post/* (/post/2020/id/title)

路径中变化的参数通过getStaticPaths来填充：

// pages/posts/[id].js
export async function getStaticPaths() {
return {
// 必须叫paths，值必须是数组
paths: [{
// 每一项必须是这个形式
params: {
// 必须含有id
id: 'ssg-ssr'
}
},{
params: {
id: 'pre-rendering'
}
}],
fallback: false
}
}

进一步传递给getStaticProps按参数获取数据，并渲染页面：

// pages/posts/[id].js
export async function getStaticProps({ params }) {
// 根据路由参数获取相应数据
const postData = await getPostData(params.id)
return {
props: {
postData
}
}
}
// 渲染页面
export default function Post({ postData }) {
return (
<Layout>
<Head>
<title>{postData.title}</title>
</Head>
<article>
<h1 className={utilStyles.headingXl}>{postData.title}</h1>
<div className={utilStyles.lightText}>
<Date dateString={postData.date} />
</div>
<div dangerouslySetInnerHTML={{ __html: postData.contentHtml }} />
</article>
</Layout>
)
}

可以理解为先创建一个工厂 page（例如pages/[路由参数1]/[路由参数2].js），接着getStaticPaths填充路由参数，getStaticProps({ params })根据参数请求不同数据，最后数据进入页面组件开始预渲染：

【JS】从 Next.js 看企业级框架的 SSR 支持

四.SSG 支持

【JS】从 Next.js 看企业级框架的 SSR 支持

最简单，同时性能也最优的预渲染方式就是静态生成（SSG），把组件渲染工作完全前移到编译时：

（编译时）获取数据

（编译时）渲染组件，生成 HTML

将生成的 HTML 静态资源托管到 Web 服务器或 CDN 即可，兼具 React 工程优势与 Web 极致性能

那么首先要解决如何获取数据的问题，Next.js 的做法是将页面依赖的数据集中管理起来：

// pages/index.js
export default function Home(props) { ... }
// 获取静态数据
export async function getStaticProps() {
// Get external data from the file system, API, DB, etc.
const data = ...
// The value of the `props` key will be
//  passed to the `Home` component
return {
props: ...
}
}

其中，getStaticProps只在服务端执行（根本不会进入客户端 bundle），返回的静态数据会传递给页面组件（上例中的Home）。也就是说，要求通过getStaticProps提前备好页面所依赖的全部数据，数据 ready 之后组件才开始渲染，并生成 HTML

P.S.注意，只有页面能通过getStaticProps声明其数据依赖，普通组件不允许，所以要求将整页依赖的所有数据都组织到一处

至于渲染生成 HTML 的部分，借助React 提供的 SSR API即可完成

至此，只要是依赖数据有办法提前获取到的页面，理论上都可以编译生成静态 HTML，但 2 个问题也随之而来：

数据可能会发生变化，已经生成的静态页面需要更新

数据量可能会多到“永远”编译不完

以电商页面为例，要把海量商品数据全都编译成静态页面，几乎是不可能的（或许要编译一个世纪那么长），即便都生成了，商品信息也会时不时地更新，静态页面需要重新生成：

因此，增量静态再生成（Incremental Static Regeneration）应运而生

ISR 支持

对于编译时无法穷举的海量页面以及需要更新的场景，Next.js 允许运行时再生成（相当于运行时静态化）：

例如：

export async function getStaticProps() {
const res = await fetch('https://.../posts')
const posts = await res.json()
return {
props: {
posts,
},
// 设置有效期，开启ISR
revalidate: 1, // In seconds
}
}

revalidate: 1表示运行时（用户请求打过来时）尝试重新生成静态 HTML，1秒最多重新生成一次

运行时静态生成需要一些时间（用户请求等着要 HTML），在此过程中有 3 种选择：

fallback: false：不降级，命中尚未生成静态页面的路由直接 404

fallback: true：降级，命中尚未生成静态页面的路由先返回降级页面（此时props为空，一般显示个 loading），静态生成 HTML 的同时会生成一份 JSON 供降级页面 CSR 使用，完成之后浏览器拿到数据（在客户端填上props），渲染出完整页面

fallback: 'blocking'：不降级，并且要求用户请求一直等到新页面静态生成结束（实际上就是 SSR，渲染过程是阻塞的，只是完成之后会保留结果 HTML）

即结合路由（getStaticPaths）对尚未生成的页面进行降级，例如：

// pages/index.js
import { useRouter } from 'next/router'
function Post({ post }) {
const router = useRouter()
// 渲染降级页面
if (router.isFallback) {
return <div>Loading...</div>
}
// Render post...
}
export async function getStaticPaths() {
return {
paths: [{ params: { id: '1' } }, { params: { id: '2' } }],
// （页面级）降级策略，true表示遇到尚未生成的先给个降级页，生成完毕后客户端自动更新过来
fallback: true,
}
}

P.S.具体见Incremental Static Regeneration、以及The fallback key

然而，并非所有场景都能愉快地在编译时静态生成。典型的，如果组件依赖的数据是动态的，显然无法在编译时预先取得数据，静态生成就无从谈起了

五.SSR 支持

对于编译时无法生成静态页面的场景，就不得不考虑 SSR 了：

【JS】从 Next.js 看企业级框架的 SSR 支持

区别于 SSG getStaticProps，Next.js 提供了 SSR 专用的getServerSideProps(context)：

// pages/index.js
export async function getServerSideProps(context) {
const res = await fetch(`https://...`)
const data = await res.json()
if (!data) {
return {
notFound: true,
}
}
return {
props: {}, // will be passed to the page component as props
}
}

同样用来获取数据，与getStaticProps最大的区别在于每个请求过来时都执行，所以能够拿到请求上下文参数（context）

P.S.更多详细信息，见getServerSideProps (Server-side Rendering)