NNext.js 中文网 GitHub

服务端渲染(SSR)

使用服务端渲染在每个请求上渲染页面。

也称为 "SSR" 或 "动态渲染"(Dynamic Rendering)。

如果某个页面使用 服务端渲染,页面 HTML 会在每次请求时生成。

要对某个页面使用服务端渲染,你需要 export 一个名为 getServerSideProps 的 async 函数。该函数会在每次请求时由服务器调用。

例如,假设你的页面需要预渲染频繁更新的数据(从外部 API 获取)。你可以编写 getServerSideProps 来获取这些数据并将其传递给 Page,如下所示:

jsx
export default function Page({ data }) {
  // 渲染数据...
}

// 每次请求时都会调用此函数
export async function getServerSideProps() {
  // 从外部 API 获取数据
  const res = await fetch(`https://.../data`)
  const data = await res.json()

  // 通过 props 将数据传递给页面
  return { props: { data } }
}

如你所见,getServerSideProps 与 getStaticProps 类似,但区别在于 getServerSideProps 在每次请求时运行,而不是在构建时运行。

要了解更多关于 getServerSideProps 工作原理的信息,请查看我们的数据获取文档。