跳到主要内容

配置错误格式

默认情况下,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',
})
© . All rights reserved.