跳到主要內容

設定錯誤格式

預設情況下，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',
})