SSG,也叫构建时预渲染

15 min read

SSR 方案虽然解决了 CSR 带来的两个问题,但是同时又引入另一个问题:需要一个服务器承载页面的实时请求、渲染和响应,这无疑会增大服务端开发和运维的成本。另外对于一些较为静态场景,比如博客、官网等,它们的内容相对来说比较确定,变化不频繁,每次通过服务端渲染出来的内容都是一样的,无疑浪费了很多没必要的服务器资源。这时,有没有一种方案可以让这些页面变得静态呢?这时,静态站点生成(SSG,也叫构建时预渲染)诞生了。

SSG(Static Site Generation) 是指在应用编译构建时预先渲染页面,并生成静态的 HTML。把生成的 HTML 静态资源部署到服务器后,浏览器不仅首次能请求到带页面内容的 HTML ,而且不需要服务器实时渲染和响应,大大节约了服务器运维成本和资源。

Next.js 默认为每个页面开启 SSG。对于页面内容需要依赖静态数据的场景,允许在每个页面中 export 一个 getStaticProps 异步函数,在这个函数中可以把该页面组件所需要的数据收集并返回。当 getStaticProps 函数执行完成后,页面组件就能在 props 中拿到这些数据并执行静态渲染。

Next.js 提供 getStaticPaths 异步函数,在这个方法中,会返回一个 paths 数组,这个数组包含了这个动态路由在构建时需要预渲染的页面数据

当我们执行 nextjs build 后,可以看到打包结果包含 pre-rendering.htmlssg-ssr.html 两个 HTML 页面,也就是说在执行 SSG 时,会对 getStaticPaths 函数返回的 paths 数组进行循环,逐一预渲染页面组件并生成 HTML

SSG 虽然很好解决了白屏时间过长和 SEO 不友好的问题,但是它仅仅适合于页面内容较为静态的场景,比如官网、博客等。面对页面数据更新频繁页面数量很多的情况,它似乎显得有点束手无策,毕竟在静态构建时不能拿到最新的数据和无法枚举海量页面。这时,就需要增量静态再生成(Incremental Static Regeneration)方案

Next.js 推出的 ISR(Incremental Static Regeneration) 方案,允许在应用运行时再重新生成每个页面 HTML,而不需要重新构建整个应用。这样即使有海量页面,也能使用上 SSG 的特性。一般来说,使用 ISR 需要 getStaticPathsgetStaticProps 同时配合使用

// pages/posts/[id].js
function Post(props) {
    const { postData } = props;

  return <div>{postData.title}</div>
}

export async function getStaticPaths() {
  const paths = await fetch('https://.../posts');
  return {
    paths,
    // 页面请求的降级策略,这里是指不降级,等待页面生成后再返回,类似于 SSR
    fallback: 'blocking'
  }
}

export async function getStaticProps({ params }) {
  // 使用 params.id 获取对应的静态数据
  const postData = await getPostData(params.id)
  return {
    props: {
      postData
    },
    // 开启 ISR,最多每10s重新生成一次页面
    revalidate: 10,
  }
}

在应用编译构建阶段,会生成已经确定的静态页面,和上面 SSG 执行流程一致。

getStaticProps 函数返回的对象中增加 revalidate 属性,表示开启 ISR。在上面的例子中,指定 revalidate = 10,表示最多10秒内重新生成一次静态 HTML。当浏览器请求已在构建时渲染生成的页面时,首先返回的是缓存的 HTML,10s 后页面开始重新渲染,页面成功生成后,更新缓存,浏览器再次请求页面时就能拿到最新渲染的页面内容了。

对于浏览器请求构建时未生成的页面时,会马上生成静态 HTML。在这个过程中,getStaticPaths 返回的 fallback 字段有以下的选项:

  • fallback: 'blocking':不降级,并且要求用户请求一直等到新页面静态生成结束,静态页面生成结束后会缓存
  • fallback: true:降级,先返回降级页面,当静态页面生成结束后,会返回一个 JSON 供降级页面 CSR 使用,经过二次渲染后,完整页面出来了

SSG + SSR

在上面介绍的 ISR 方案时提及过,ISR 的实质是 SSG + SSR:

  • 静态内容走 SSG:编译构建时把相对静态的页面预先渲染生成 HTML,浏览器请求时直接返回静态 HTML
  • 动态内容走 SSR:浏览器请求未预先渲染的页面,在运行时通过 SSR 渲染生成页面,然后返回到浏览器,并缓存静态 HTML,下次命中缓存时直接返回

ISR 相比于 SSG + CSR 来说,动态内容可以直接直出,进一步提升了首次访问页面时的体验;相比于 SSR + CSR 来说,减少没必要的静态页面渲染,节省了一部分后端服务器成本。