前言

Next.js 是由 Vercel 团队研发的一款全栈应用开发框架，我们使用 Next.js 开发前端页面以及一些轻量级的后端 API，前端和后端都用 Javascript 技术栈，并且是前后端一体化的（在同一个项目中开发前后端）。另一个被大家所熟知的特性是它的服务端渲染能力，对 SEO 友好。Vercel 自身是一个用户体验极佳的 Serverless 平台，支持包括 Next.js 在内的几十种开发框架一键部署到 Vercel 平台。Vercel 平台自身拥有极强的适配扩展能力，第三方框架可以按照 Vercel 平台的适配规则自主进行适配。作为 Vercel 亲儿子的 Next.js 可以完美适配 Vercel 平台，通过 Next.js + Vercel，让开发和部署都能拥有极致的体验。Vercel 团队信奉着“吃自己的狗粮”原则，很多应用都是基于自己的工具和平台开发的。

美中不足

Next.js + Vercel 看起来是如此的完美：通过 Vercel CLI 一键部署 Next.js 到 Vercel。另外，Next.js 也能很方便地运行在云主机上。但是 Vercel 作为国外的 Serverless 平台，对于国内用户，总是存在种种难以逾越的限制。如何将 Next.js 完美运行在国内的 Serverless 平台变得尤为重要。

国内 Serverless 平台官方在如何让 Next.js 运行起来的问题上各显神通。让 Next.js 在 Serverless 平台上运行不难，而要做到像 Vercel 一样的极致部署运行体验却很有挑战。

在尝试将 Next.js 部署到国内 Serverless 平台的时候，比如腾讯云函数、阿里云函数计算，可能会遇到如下一些坑：

• 运行适配困难：Next.js 的运行需要一个 HTTP Server，而事件函数提供的是一个简单签名函数，无法直接运行，需要将事件函数模拟成一个近似 HTTP Server 的代理服务；

• 代码体积过大：一个最简单的 Next.js 应用的代码体积为 245MB 左右，打包压缩后是 54MB 左右，而函数代码体积限制一般是在 50MB 以内（阿里云函数计算通过 OSS 方式上传代码可以超过 50MB 的限制，但不能超过 100MB）。代码体积过大往往带来一系列副作用：

  a. 代码上传时间长，且容易失败，部署成本变大（可以通过 NFS 和 Layer 解决）；

  b. 依赖更多云服务，如使用对象存储服务部署代码包，又或者把体积大的 node_modules 目录上传到 NFS 服务上，然后挂载到函数上。总之，让应用架构变复杂；

  c. 冷启动时间变长，函数在第一次运行的时候，需要先加载远端的代码，如果代码包越大，则冷启动时间越长。

不过，通过腾讯云的 Web 函数和阿里云函数计算的 Custom Runtime，可以解决第一个问题，因为它允许我们运行一个真正的 HTTP Server。而第二个问题要困难很多，虽然其中部分问题可以通过一定手段缓解，比如冷启动可以通过预置并发解决，但是又会让运行成本变得难以接受。所以解决问题的根本还是在代码体积上。

为什么 Next.js 项目代码体积大

为了分析这个问题，我们需要先了解 Next.js 的架构。Next.js 是一种 React 的服务端渲染框架，集成度极高，框架自身集成了 Webpack、SWC、Babel、Express 等，使得开发者仅依赖 Next、React 和 React-dom 就可以方便地构建自己的 SSR React 应用，我们甚至可以不用关心路由。Next.js 的高度集成性，易于实现代码分割、路由跳转、热更新、服务端渲染和前端渲染。

在 Next.js 项目中，不仅仅包含了运行时所需要的依赖，还包含了本地开发、构建所需要的开发时依赖，而且开发时依赖体积又大。我们常见的解决方案是简单粗暴打包所有的依赖，从而导致 Next.js 项目代码偏大。

Vercel 官方如何打包部署 Next.js

Vercel 官方打包部署 Next.js 的方案比较复杂。Vercel 平台底层基础设施集成了 AWS Lambda，Next.js 本质是部署在 AWS Lambda 平台上。为了能让 Next.js 在 Lambda 上运行，Vercel 官方提供了一个专门用于构建 Next.js 项目的构建器：@vercel/next。该构建器的逻辑大致是把 Next.js 中的每一个 API 和服务端渲染的页面都分别构建输出为一个函数，这一系列函数都归属与 Vercel 平台上的一个应用。这样就保证了每个函数的代码体积足够小。

预览

Next.js 打包部署到国内 Serverless 平台最佳实践

解决函数适配困难：我们可以通过 Web 函数或者 Custom Runtime 来解决（不推荐使用自定义镜像的方式，因为自定义镜像冷启动很严重），并在其中运行一个 HTTP Server，且简单适配 Next.js，这里在 Next.js 官方有示例。

解决代码包体积过大问题：可以剔除掉运行时不需要的可选依赖和开发依赖，剔除方式如下：

npm install --omit optional --omit dev
 # 或者
yarn install --ignore-optional --prod

说明：因为 swc 构建工具是通过可选依赖安装的，在运行时不需要，所以我们需要把可选依赖也剔除。

通过以上方式构建的代码体积由原来的 54MB 减小到了 18MB。另外，值得一提的是阿里云函数计算 Custom Runtime 内置的 Node.js 版本为 v10.16.2，而 Next.js 最新版本要求必须是 Node.js 12.22.0+。所有直接部署在函数计算的 Custom Runtime 上的 Next.js 应用无法运行，此时我们需要自行将 Node.js 的二进制下载到我们自己的代码中（也可以通过 Layer 实现），然后指定新的 PATH 环境变量。

如果每次都需要做上面的操作会很繁琐，而且还需要自己写适配入口代码，以及 Web 函数和 Custom Runtime 所必须的 bootstrap 文件，且该文件必须拥有可执行权限，在运行时额外安装新版 Node.js。其实这些能力在 Cloud Studio (https://cloudstudio.net/) 云开发平台中已经内置提供了。针对一个原生的 Next.js 应用，使用 Cloud Studio 云开发平台可以一键部署到腾讯云函数或者阿里函数计算，对业务代码零侵入，零门槛，只需如下几步：

1. 登录进入 Cloud Studio 的 Dashboard 页面https://cloudstudio.net/

   

   预览

2. 选择 Next.js 模板，并创建一个工作空间。

   

   预览
   

   预览

3. 切换到 Cloud Studio 云部署套件视图。

   

   预览

4. 选择腾讯云部署选项，并微信扫码登录。

   

   预览
   

   预览

5. 点击【开始部署】按钮，一键部署 Next.js 应用。

   

   预览
   

   预览

6. 点击【访问】按钮，即刻预览部署后的效果。

   

   预览

   说明：同样的 Next.js 应用，无需做任何修改，采用上述一样的步骤一键部署。

Cloud Studio 是基于浏览器的集成式开发环境（IDE），为开发者提供了一个永不间断的云端工作站。其包含代码高亮、自动补全、Git 集成、终端等 IDE 的基础功能，同时支持实时调试、插件扩展等，可以帮助开发者快速完成各种应用的开发、编译与部署工作。用户在使用 Cloud Studio 时无需安装，随时随地打开浏览器就能使用。

目前 Cloud Studio 支持部署到腾讯云函数和阿里云函数计算，并且支持 15+ 前后端框架的一键部署。

预览

写在最后

从开始的胡乱打包，到后面的精致打包，让代码体积变小，可以帮助大家避免一系列的坑。至于我们为什么不采用像 Vercel 那样的极致方案，原因有三点：实现成本太高、对 Next.js API 深度依赖，维护成本高和构建成多个函数管理成本极大（我们不可能像 Vercel 一样提供一个高阶平台）。通过 Cloud Studio (https://cloudstudio.net/) 云开发平台，我们可以一键部署 Next.js 等流行框架，对框架零改造。