跳到主要内容

配置错误格式

默认情况下，Prisma 客户端使用 ANSI 转义字符 来美化错误堆栈并提供有关如何解决问题的建议。虽然这在从终端使用 Prisma 客户端时非常有用，但在 GraphQL API 等上下文中，您只需要最少的错误，而无需任何额外的格式。

本页说明了如何使用 Prisma 客户端配置错误格式。

格式化级别​

有 3 个错误格式化级别

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

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

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

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

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

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

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

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