NNext.js 中文网 GitHub

如何为生产环境优化你的 Next.js 应用

在将 Next.js 应用投入生产环境之前,为确保最佳性能和用户体验而提供的建议。

在将 Next.js 应用投入生产之前,你应该考虑实施一些优化和模式,以获得最佳的用户体验、性能和安全性。

本页提供了一些最佳实践,可在构建应用时和投入生产之前作为参考,同时介绍了你应该了解的 Next.js 自动优化。

自动优化#

这些 Next.js 优化默认启用,无需任何配置:

  • Server Components:Next.js 默认使用 Server Components。Server Components 在服务端运行,不需要 JavaScript 即可在客户端渲染。因此,它们不会影响客户端 JavaScript bundle 的大小。你可以根据需要使用 Client Components 来实现交互。
  • 代码分割(Code-splitting):Server Components 支持按路由片段自动进行代码分割。在适当的情况下,你还可以考虑对 Client Components 和第三方库进行懒加载。
  • 预取(Prefetching):当指向新路由的链接进入用户视口时,Next.js 会在后台预取该路由。这使得导航到新路由几乎是即时的。你可以在适当的情况下选择退出预取。
  • 预渲染(Prerendering):Next.js 在构建时于服务端预渲染 Server Components 和 Client Components,并缓存渲染结果以提升应用性能。你可以在适当的情况下为特定路由选择动态渲染(Dynamic Rendering)。
  • 缓存(Caching):Next.js 会缓存数据请求、Server Components 和 Client Components 的渲染结果、静态资源等,以减少对服务器、数据库和后端服务的网络请求数量。你可以在适当的情况下选择退出缓存。
  • 代码分割:Next.js 会自动按页面对你的应用代码进行代码分割。这意味着导航时只加载当前页面所需的代码。在适当的情况下,你还可以考虑对第三方库进行懒加载。
  • 预取:当指向新路由的链接进入用户视口时,Next.js 会在后台预取该路由。这使得导航到新路由几乎是即时的。你可以在适当的情况下选择退出预取。
  • 自动静态优化:如果页面没有阻塞性的数据需求,Next.js 会自动判定该页面是静态的(可被预渲染)。优化后的页面可以被缓存,并从多个 CDN 位置提供给最终用户。你可以在适当的情况下选择服务端渲染。

这些默认设置旨在提升应用性能,并降低每次网络请求的成本和传输的数据量。

开发期间#

在构建应用时,我们建议使用以下功能以确保最佳性能和用户体验:

路由与渲染#

数据获取与缓存#

  • Server Components:利用 Server Components 在服务端获取数据的优势。
  • Route Handlers:使用 Route Handlers 从 Client Components 访问后端资源。但不要从 Server Components 调用 Route Handlers,以避免额外的服务端请求。
  • Streaming(流式渲染):使用 Loading UI 和 React Suspense 逐步将 UI 从服务端发送到客户端,并防止在获取数据时整个路由被阻塞。
  • 并行数据获取:在适当的情况下并行获取数据,以减少网络瀑布流。
  • 数据缓存:确认你的数据请求是否被缓存,并在适当的情况下选择缓存。确保不使用 fetch 的请求也被缓存。
  • 静态图片:使用 public 目录自动缓存应用的静态资源,例如图片。
  • API Routes:使用 Route Handlers 访问后端资源,并防止敏感密钥暴露给客户端。
  • 数据缓存:确认你的数据请求是否被缓存,并在适当的情况下选择缓存。确保在适当的情况下缓存不使用 getStaticProps 的请求。
  • Incremental Static Regeneration:使用 Incremental Static Regeneration 在静态页面构建完成后更新它们,而无需重建整个站点。
  • 静态图片:使用 public 目录自动缓存应用的静态资源,例如图片。

UI 与无障碍访问#

  • 表单与验证:使用 Server Actions 处理表单提交、服务端验证和错误处理。
  • 全局错误 UI:添加 app/global-error.tsx,为整个应用中未捕获的错误提供一致且无障碍的 fallback UI 和恢复机制。
  • 全局 404:添加 app/global-not-found.tsx,为应用中不匹配任何路由的请求提供无障碍的 404 页面。
  • Font Module:使用 Font Module 优化字体,它会自动将字体文件与其他静态资源一起托管,消除外部网络请求,并减少布局偏移。
  • <Image> 组件:使用 Image 组件优化图片,它会自动优化图片、防止布局偏移,并以 WebP 等现代格式提供图片。
  • <Script> 组件:使用 Script 组件优化第三方脚本,它会自动延迟脚本加载,防止其阻塞主线程。
  • ESLint:使用内置的 eslint-plugin-jsx-a11y 插件尽早发现无障碍访问问题。

安全性#

  • 环境变量:确保你的 .env.* 文件已添加到 .gitignore 中,并且只有公开变量才使用 NEXT_PUBLIC_ 前缀。
  • 内容安全策略(Content Security Policy):考虑添加内容安全策略,以保护你的应用免受跨站脚本、点击劫持和其他代码注入攻击等各种安全威胁。

元数据与 SEO#

  • Metadata API:使用 Metadata API 添加页面标题、描述等,以改善应用的搜索引擎优化(SEO)。
  • Open Graph(OG)图片:创建 OG 图片,为应用的社交分享做好准备。
  • Sitemaps 和 Robots:通过生成 sitemap 和 robots 文件,帮助搜索引擎抓取和索引你的页面。
  • <Head> 组件:使用 next/head 组件添加页面标题、描述等。

类型安全#

  • TypeScript 和 TS Plugin:使用 TypeScript 和 TypeScript 插件以获得更好的类型安全性,并帮助你尽早发现错误。

投入生产之前#

在投入生产之前,你可以运行 next build 在本地构建应用并捕获任何构建错误,然后运行 next start 在类似生产环境的条件下测量应用性能。

Core Web Vitals#

  • Lighthouse:在无痕模式下运行 Lighthouse,以更好地了解用户访问你网站的体验,并找出需要改进的地方。这是一项模拟测试,应结合实际数据(如 Core Web Vitals)一起分析。

分析 bundle#

使用 @next/bundle-analyzer 插件分析 JavaScript bundle 的大小,并找出可能影响应用性能的大型模块和依赖。

此外,以下工具可以帮助你了解向应用添加新依赖所带来的影响:

Next.js 中文网