增量靜態再生（Incremental Static Regeneration，簡稱 ISR） 是 Next.js 提供的一項創新功能，它允許開發者在不進行完整構建的情況下，動態更新靜態頁面。這項技術結合了靜態站點生成（SSG） 的高效性與服務器端渲染（SSR） 的動態特性，使其成為現代 Web 開發中的強大解決方案。

什么是增量靜態再生（ISR）？

在 Next.js 中，ISR 允許靜態頁面在初始構建完成后進行更新，而無需重新生成整個網站。它通過后臺再生頁面內容，確保頁面內容保持最新，同時保留靜態生成的性能優勢。這種方式兼顧了靜態站點生成（SSG）和服務器端渲染（SSR）的優點，提供了更靈活的內容更新方案。

ISR 的核心概念

ISR 結合了靜態站點生成（SSG） 和 服務器端渲染（SSR） 的特性，以下是它的核心概念：

1. 增量靜態再生

ISR 允許靜態頁面在初始構建后按需更新，只再生有變更的頁面，而不影響其他頁面的靜態內容。

2. revalidate 屬性

在 getStaticProps 方法中，revalidate 允許開發者指定一個時間間隔（秒）。每當這個時間間隔過去后，新的請求將觸發后臺再生。

示例代碼：

export async function getStaticProps() {
  const res = await fetch("https://api.example.com/data");
  const data = await res.json();

  return {
    props: { data },
    revalidate: 10, // 每 10 秒重新驗證并更新頁面
  };
}

3. 按需更新內容

頁面的再生基于用戶請求觸發，當 revalidate 時間間隔到達時，首次請求將觸發頁面的后臺更新，更新后的內容將在后續請求中生效。

4. 結合靜態與動態內容

ISR 允許預生成靜態頁面，并在其上動態更新，使網站可以在保證快速加載的同時，保持內容的時效性。

5. 提升性能

通過 ISR，頁面默認以靜態方式加載，帶來更快的訪問速度，而后臺的增量更新避免了完整構建帶來的性能損耗。

6. 增強 SEO

ISR 允許搜索引擎獲取完整的 HTML 頁面，并且頁面內容始終是最新的，有助于提升 SEO 表現。

7. 減少構建時間

由于 ISR 僅更新需要更新的頁面，網站不必每次都進行完整構建，這對于大規模站點尤為重要。

ISR 的工作原理

ISR 的核心機制如下：

• 頁面在初次構建時被靜態生成，并存儲為靜態 HTML。
• 在 revalidate 設定的時間間隔內，所有訪問者都會看到緩存的靜態頁面。
• 時間間隔到達后，首次訪問該頁面的用戶將觸發后臺再生，同時頁面仍然提供緩存內容，避免等待。
• 再生完成后，新的靜態頁面被替換，所有后續訪問者都將看到更新后的頁面。

在 Next.js 中實現 ISR

第一步：創建動態頁面

創建一個動態頁面，比如博客文章頁面：

// pages/posts/[slug].js
import { useRouter } from "next/router";
import { getPost, getAllPostSlugs } from "../../lib/api";

export default function Post({ post }) {
  const router = useRouter();

  if (router.isFallback) {
    return <div>加載中...</div>;
  }

  return (
    <div>
      <h1>{post.title}</h1>
      <p>{post.content}</p>
    </div>
  );
}

// 獲取所有文章的路徑
export async function getStaticPaths() {
  const slugs = await getAllPostSlugs();

  return {
    paths: slugs.map((slug) => ({
      params: { slug },
    })),
    fallback: true, // 開啟 ISR
  };
}

// 生成靜態頁面并設置 revalidate
export async function getStaticProps({ params }) {
  const post = await getPost(params.slug);

  return {
    props: { post },
    revalidate: 60, // 每 60 秒再生頁面
  };
}

第二步：創建 API 方法

編寫 API 方法來獲取數據，例如模擬博客文章的獲取：

// lib/api.js

// 獲取所有文章 slug
export async function getAllPostSlugs() {
  return [{ slug: "first-post" }, { slug: "second-post" }].map(
    (post) => post.slug
  );
}

// 獲取單篇文章數據
export async function getPost(slug) {
  const posts = {
    "first-post": {
      title: "第一篇文章",
      content: "這是第一篇文章的內容。",
    },
    "second-post": {
      title: "第二篇文章",
      content: "這是第二篇文章的內容。",
    },
  };
  return posts[slug] || null;
}

第三步：運行 Next.js 應用

使用以下命令運行你的 Next.js 項目：

npm run dev

訪問博客頁面，ISR 機制會在 revalidate 指定的時間間隔后自動更新頁面內容。

關鍵字解釋

• getStaticPaths：確定哪些路徑應預先渲染。 fallback: true 設置允許 Next.js 按需生成頁面。
• getStaticProps：在構建時獲取每個帖子的數據，并包含一個 revalidate 屬性，該屬性指定了重新生成頁面前的等待時間（以秒為單位）。
• revalidate：控制 ISR，確保頁面以指定的時間間隔在后臺重新生成，從而在不完全重建的情況下保持內容最新。

ISR 的優勢

ISR 的應用場景

ISR 適用于多種 Web 應用場景，包括：

• 電商網站：商品詳情頁、分類頁面等可定期更新數據，同時保持靜態頁面的快速響應。
• 新聞網站：新聞文章頁面在保證 SEO 的同時，能夠實時更新內容。
• 博客：博客文章既可以靜態化提高訪問速度，又可以定期更新內容。
• 文檔網站：API 文檔、教程等內容可按需更新，保持時效性。
• 營銷網站：著陸頁、案例頁面等可快速加載，同時保持營銷內容的更新。
• 招聘網站：職位列表、公司詳情頁等可以增量更新，而不影響整體性能。

總結

增量靜態再生（ISR）是 Next.js 提供的一項強大功能，它結合了靜態站點生成的高性能與服務器端渲染的動態更新能力。借助 ISR，開發者可以構建高效、SEO 友好且始終保持最新內容的網站，而無需每次都進行完整構建。

如果你正在開發一個需要頻繁更新但又想保持靜態站點性能的應用，ISR 是一個理想的解決方案。希望本指南能幫助你掌握 ISR 的原理及應用，讓你的 Next.js 項目更加高效、靈活！