Vercel 构建依赖项缓存解决方法

问题

如果您使用 Prisma ORM 将应用程序部署到 Vercel，您可能会在部署时遇到以下错误消息

Prisma has detected that this project was built on Vercel, which caches dependencies.
This leads to an outdated Prisma Client because Prisma's auto-generation isn't triggered.
To fix this, make sure to run the `prisma generate` command during the build process.

Learn how: https://pris.ly/d/vercel-build

这是因为 Vercel 会缓存项目依赖项，直到其中一个依赖项发生更改。它这样做是为了加快构建速度，虽然这通常是一件好事，但它会导致 Prisma Client 出现一些问题。

Prisma ORM 使用一个 postinstall 钩子，在安装依赖项时生成 Prisma Client。由于 Vercel 使用缓存的模块，因此在初始部署后的后续部署中，此 postinstall 钩子永远不会执行。这会导致 Prisma Client 与您的数据库架构不同步。

此错误消息可以防止这种情况发生，并引导您到此处，了解如何修复根本问题。

4.13.0 之前的 Prisma Client 版本

在低于 4.13.0 的 Prisma Client 版本上，您可能会遇到类似以下的错误消息

// 1: When adding a field:
Unknown arg `name` in data.name for type UserCreateInput. Did you mean `nick`?

// 2: When removing a field:
Invalid `prisma.user.create()` invocation: The column `User.name` does not exist in the current database.

// 3: When a model was removed/renamed
Invalid `prisma.user.deleteMany()` invocation: The table `public.User` does not exist in the current database.

// 4: When a model was added
Cannot read properties of undefined (reading 'create')

本指南中描述的解决方案旨在解决这些问题。

解决方案

可以通过在每次部署时显式生成 Prisma Client 来解决此问题。在每次部署之前运行 prisma generate 将确保 Prisma Client 最新。

您可以通过多种不同的方式配置部署以运行此命令

自定义 postinstall 脚本

info

这是首选方法，因为它是一种通用解决方案。

在项目 package.json 文件的 scripts 部分，如果还没有名为 postinstall 的脚本，请添加一个，并将 prisma generate 添加到该脚本中

{
  ...
  "scripts" {
    "postinstall": "prisma generate"
  }
  ...
}

package.json 中应用程序的 build 脚本

在项目 package.json 文件的 scripts 部分，在 build 脚本中，将 prisma generate 添加到默认 vercel build 命令之前

{
  ...
  "scripts" {
    "build": "prisma generate && <actual-build-command>"
  }
  ...
}

Vercel UI 的构建脚本字段

另一种配置 prisma generate 以在每次部署时运行的方法是将命令添加到构建设置中，通过 Vercel 的 UI。

在项目的仪表板中，转到“设置”选项卡并找到“常规”部分。在该部分中，您会找到一个名为“构建和开发设置”的框，其中包含一个名为“构建命令”的输入字段

在该字段中，将 prisma generate 添加到现有脚本之前