跳到主要内容

Netlify 构建依赖缓存变通方案

问题​

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

Prisma has detected that this project was built on Netlify, 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/netlify-build

这是因为 Netlify 会缓存项目的依赖项，直到其中一个依赖项发生变化。这样做是为了加快构建速度，通常情况下这是件好事，但它会给 Prisma Client 带来一些问题。

Prisma ORM 使用一个 postinstall 钩子来在安装依赖项时生成 Prisma Client。由于 Netlify 使用缓存的模块，这个 postinstall 钩子在首次部署后的后续部署中从未运行。这导致 Prisma Client 与您的数据库 schema 不同步。

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

Prisma Client 版本低于 4.13.0

在 Prisma Client 版本低于 4.13.0 时，您可能会遇到看起来像以下的错误消息

// 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 脚本​

信息

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

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

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

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

在项目的 package.json 文件中的 scripts 部分，在 build 脚本内，将 prisma generate 前置到现有的构建命令前

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

Netlify UI 的构建脚本字段​

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

在您的项目控制面板中，转到 Site Settings（站点设置）选项卡，找到 Build & deploy（构建与部署）部分。在该部分中，进入 Continuous deployment（持续部署）子部分。

找到该部分中标有 Build settings（构建设置）的框，并点击 Edit settings（编辑设置）按钮

Netlify project dashboard&#39;s Build settings button

点击该按钮将打开一个包含各种字段的表单。找到 Build command（构建命令）字段，并将 prisma generate 前置到现有的脚本前

Netlify project dashboard&#39;s Build command setting filled