如何为生产环境优化你的 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 的渲染结果、静态资源等,以减少对服务器、数据库和后端服务的网络请求数量。你可以在适当的情况下选择退出缓存。
这些默认设置旨在提升应用性能,并降低每次网络请求的成本和传输的数据量。
开发期间#
在构建应用时,我们建议使用以下功能以确保最佳性能和用户体验:
路由与渲染#
- Layouts(布局):使用 Layouts 在多个页面之间共享 UI,并在导航时启用部分渲染。
<Link>组件:使用<Link>组件实现客户端导航和预取。- 错误处理:通过创建自定义错误页面,在生产环境中优雅地处理通用错误和 404 错误。
- Client 和 Server Components:遵循 Server Components 和 Client Components 推荐的组合模式,并检查
"use client"边界的位置,避免不必要地增大客户端 JavaScript bundle。 - 请求时 API(Request-time APIs):诸如
cookies和searchParamsprop 之类的请求时 API 会读取只有在用户发起请求时才知道的数据。请将使用它们的组件包裹在<Suspense>中,以便路由的其余部分仍然可以被预渲染。如果没有 Cache Components,使用它们会使整个路由选择动态渲染(如果在根 Layout 中使用,则会使整个应用选择动态渲染)。
数据获取与缓存#
- 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 与无障碍访问#
- Font Module:使用 Font Module 优化字体,它会自动将字体文件与其他静态资源一起托管,消除外部网络请求,并减少布局偏移。
<Image>组件:使用 Image 组件优化图片,它会自动优化图片、防止布局偏移,并以 WebP 等现代格式提供图片。<Script>组件:使用 Script 组件优化第三方脚本,它会自动延迟脚本加载,防止其阻塞主线程。- ESLint:使用内置的
eslint-plugin-jsx-a11y插件尽早发现无障碍访问问题。
安全性#
- 数据污染标记(Tainting):通过对数据对象和/或特定值添加污染标记,防止敏感数据暴露给客户端。
- Server Actions:在每个 action 内部验证身份验证和授权。不要仅依赖 Proxy、layout 或页面级别的检查。将数据库访问移至
server-only的数据访问层,并考虑对开销较大的操作实施速率限制。请查看推荐的安全实践。
- 环境变量:确保你的
.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)一起分析。
useReportWebVitalshook:使用此 hook 将 Core Web Vitals 数据发送到分析工具。
分析 bundle#
使用 @next/bundle-analyzer 插件分析 JavaScript bundle 的大小,并找出可能影响应用性能的大型模块和依赖。
此外,以下工具可以帮助你了解向应用添加新依赖所带来的影响: