跳到主要内容

配置错误格式化

默认情况下，Prisma Client 使用 ANSI 转义字符 来美化打印错误堆栈，并提供关于如何解决问题的建议。虽然这在使用终端中的 Prisma Client 时非常有用，但在诸如 GraphQL API 之类的上下文中，您只需要没有任何额外格式的最小错误。

本页解释了如何使用 Prisma Client 配置错误格式化。

格式化级别​

有 3 种错误格式化级别

  1. 美观错误（默认）：包括完整的堆栈跟踪，带有颜色、代码语法高亮以及包含问题可能解决方案的扩展错误消息。
  2. 无色错误：与美观错误相同，只是没有颜色。
  3. 最小错误：原始错误消息。

为了配置这些不同的错误格式化级别，有两种选择

  • 通过环境变量设置配置选项
  • 将配置选项提供给 PrismaClient 构造函数

通过环境变量进行格式化​

  • NO_COLOR：如果提供了此环境变量，则会从错误消息中剥离颜色。因此，您最终会得到一个无色错误。NO_COLOR 环境变量是一个此处描述的标准。
  • NODE_ENV=production：如果环境变量 NODE_ENV 设置为 production，则只会打印最小错误。这使得在生产环境中更容易消化日志。

通过 PrismaClient 构造函数进行格式化​

或者，使用 PrismaClient errorFormat 参数来设置错误格式

const prisma = new PrismaClient({
  errorFormat: 'pretty',
})