跳到主要内容

错误消息参考

有关如何使用异常和错误代码的更多信息,请参阅 处理异常和错误

Prisma Client 错误类型

Prisma Client 抛出不同类型的错误。以下列出异常类型及其文档化的数据字段

PrismaClientKnownRequestError

如果查询引擎返回与请求相关的已知错误(例如,唯一约束冲突),则 Prisma Client 抛出 PrismaClientKnownRequestError 异常。

属性描述
code一个 Prisma 特定的 错误代码
meta有关错误的附加信息 - 例如,导致错误的字段:{ target: [ 'email' ] }
message错误代码 关联的错误消息。
clientVersionPrisma Client 的版本(例如,2.19.0

PrismaClientUnknownRequestError

如果查询引擎返回与没有错误代码的请求相关的错误,则 Prisma Client 抛出 PrismaClientUnknownRequestError 异常。

属性描述
message错误代码 关联的错误消息。
clientVersionPrisma Client 的版本(例如,2.19.0

PrismaClientRustPanicError

如果底层引擎崩溃并以非零退出代码退出,则 Prisma Client 抛出 PrismaClientRustPanicError 异常。在这种情况下,必须重新启动 Prisma Client 或整个 Node 进程。

属性描述
message错误代码 关联的错误消息。
clientVersionPrisma Client 的版本(例如,2.19.0

PrismaClientInitializationError

如果在启动查询引擎并创建与数据库的连接时出现问题,则 Prisma Client 抛出 PrismaClientInitializationError 异常。这会在以下情况下发生

  • 当调用 prisma.$connect() 时 OR
  • 当执行第一个查询时

可能发生的错误包括

  • 提供的数据库凭据无效
  • 在提供的主机名和端口下没有正在运行的数据库服务器
  • 查询引擎 HTTP 服务器要绑定的端口已被占用
  • 缺少或无法访问的环境变量
  • 找不到当前平台的查询引擎二进制文件(generator 块)
属性描述
errorCode一个 Prisma 特定的错误代码。
message错误代码 关联的错误消息。
clientVersionPrisma Client 的版本(例如,2.19.0

PrismaClientValidationError

如果验证失败,则 Prisma Client 抛出 PrismaClientValidationError 异常 - 例如

  • 缺少字段 - 例如,在创建新记录时为空的 data: {} 属性
  • 提供了不正确的字段类型(例如,将 Boolean 字段设置为 "Hello, I like cheese and gold!"
属性描述
message错误消息。
clientVersionPrisma Client 的版本(例如,2.19.0

错误代码

常用

P1000

"针对 {database_host} 的数据库服务器的身份验证失败,为 {database_user} 提供的数据库凭据无效。请确保为 {database_host} 的数据库服务器提供有效的数据库凭据。"

P1001

"无法访问 {database_host}:{database_port} 的数据库服务器。请确保您的数据库服务器正在 {database_host}:{database_port} 上运行。"

P1002

"已访问 {database_host}:{database_port} 的数据库服务器,但超时。请重试。请确保您的数据库服务器正在 {database_host}:{database_port} 上运行。 "

P1003

"数据库 {database_file_name} 在 {database_file_path} 不存在"

"数据库 {database_name}.{database_schema_name}{database_host}:{database_port} 的数据库服务器上不存在。"

"数据库 {database_name}{database_host}:{database_port} 的数据库服务器上不存在。"

P1008

"操作在 {time} 后超时"

P1009

"数据库 {database_name} 已存在于 {database_host}:{database_port} 的数据库服务器上"

P1010

"用户 {database_user} 被拒绝访问数据库 {database_name}"

P1011

"打开 TLS 连接时出错:{message}"

P1012

注意:如果您在将 Prisma ORM 升级到 4.0.0 或更高版本后收到错误代码 P1012,请参阅4.0.0 版本升级指南。在 4.0.0 版本之前有效的架构在 4.0.0 及更高版本中可能无效。升级指南说明了如何更新您的架构以使其有效。

"{full_error}"

可能的 P1012 错误消息

  • "缺少参数 {}。"
  • "函数 {} 接受参数,但收到."
  • "属性 @{} 中缺少参数 {}。"
  • "数据源块 {} 中缺少参数 {}。"
  • "生成器块 {} 中缺少参数 {}。"
  • "解析属性 @{} 时出错"
  • "属性 @{} 定义了两次。"
  • "无法定义数据库名称为 {} 的模型,因为另一个具有此名称的模型存在:{}"
  • "{} 是保留的标量类型名称,不能使用。"
  • "The {} 不能定义,因为一个具有该名称的已经存在。"
  • "键 {} 已在."
  • "参数 {} 已指定为未命名参数。"
  • "参数 {} 已指定。"
  • "没有这样的参数。""
  • "字段 {} 已在模型 {} 上定义。"
  • "模型 {} 中的字段 {} 不能是列表。当前连接器不支持基本类型的列表。"
  • "索引名称 {} 已多次声明。使用当前连接器,索引名称必须是全局唯一的。"
  • "值 {} 已在枚举 {} 上定义。"
  • "未知属性:@{}。"
  • "未知函数:{}。"
  • "未知数据源提供程序:{}。"
  • "数据源 {} 的 shadowDatabaseUrl 与 url 相同。请指定不同的数据库作为影子数据库。"
  • "预览功能 {} 未知。预期为以下之一"
  • "{} 不是有效的."
  • "类型 {} 既不是内置类型,也不引用另一个模型、自定义类型或枚举。"
  • "类型 {} 不是内置类型。"
  • "意外的标记。预期为以下之一"
  • "找不到环境变量."
  • "预期为值,但收到{}。"
  • "预期为值,但在解析 {} 时失败."
  • "验证模型 {} 时出错"
  • "验证模型 {} 中字段 {} 时出错"
  • "验证数据源 {datasource} 时出错:{message}"
  • "验证枚举 {} 时出错"
  • "验证时出错"

P1013

"提供的数据库字符串无效。{details}"

P1014

"模型 {model} 的底层 {kind} 不存在。"

P1015

"您的 Prisma 架构正在使用数据库版本不支持的功能。
数据库版本:{database_version}
错误
{errors}"

P1016

"您的原始查询的参数数量不正确。预期:{expected},实际:{actual}。"

P1017

"服务器已关闭连接。"

Prisma Client(查询引擎)

P2000

"为列提供的值对于列的类型来说太长。列:{column_name}"

P2001

"在 where 条件中搜索的记录({model_name}.{argument_name} = {argument_value})不存在"

P2002

“唯一约束失败,约束条件为:{constraint}”

P2003

“外键约束失败,字段为:{field_name}

P2004

“数据库约束失败:{database_error}

P2005

“字段 {field_name} 在数据库中存储的值 {field_value} 对于该字段的类型无效”

P2006

“为 {model_name} 模型的字段 {field_name} 提供的 {field_value} 值无效”

P2007

“数据验证错误:{database_error}

P2008

“解析查询失败:{query_parsing_error},位置在:{query_position}

P2009

“验证查询失败:{query_validation_error},位置在:{query_position}

P2010

“原始查询失败。代码:{code}。消息:{message}

P2011

“空值约束冲突,约束条件为:{constraint}”

P2012

“在 {path} 处缺少必需的值”

P2013

“在 {object_name} 的字段 {field_name} 上缺少必需的参数 {argument_name}。”

P2014

“您尝试进行的更改将违反 {model_a_name}{model_b_name} 模型之间必需的关系 '{relation_name}'。”

P2015

“找不到相关的记录。{details}”

P2016

“查询解析错误。{details}”

P2017

{parent_name}{child_name} 模型之间关系 {relation_name} 的记录未连接。”

P2018

“找不到必需的连接记录。{details}”

P2019

“输入错误。{details}”

P2020

“该类型的值超出范围。{details}”

P2021

“当前数据库中不存在表 {table}。”

P2022

“当前数据库中不存在列 {column}。”

P2023

“列数据不一致:{message}”

P2024

“从连接池获取新连接超时。(更多信息:http://pris.ly/d/connection-pool)(当前连接池超时时间:{timeout},连接限制:{connection_limit})”

P2025

“操作失败,因为它依赖于一个或多个必需但未找到的记录。{cause}”

P2026

“当前数据库提供程序不支持查询使用的功能:{feature}”

P2027

“查询执行期间数据库发生多个错误:{errors}”

P2028

“事务 API 错误:{error}”

P2029

“查询参数超出限制错误:{message}”

P2030

“找不到用于搜索的全文索引,尝试在你的架构中添加 @@fulltext([Fields...])”

P2031

“Prisma 需要执行事务,这要求你的 MongoDB 服务器作为副本集运行。查看详情:https://pris.ly/d/mongodb-replica-set

P2033

“查询中使用的数字不适合 64 位有符号整数。如果您尝试存储大整数,请考虑使用 BigInt 作为字段类型”

P2034

“事务因写入冲突或死锁而失败。请重试您的事务”

P2035

“数据库断言违反:{database_error}”

P2036

“外部连接器错误(id {id})”

P2037

“打开的数据库连接过多:{message}”

Prisma Migrate (Schema Engine)

警告

Schema Engine 之前被称为 Migration Engine。此更改在版本 5.0.0 中引入。

P3000

“创建数据库失败:{database_error}”

P3001

“迁移可能需要进行破坏性更改,并可能导致数据丢失:{migration_engine_destructive_details}”

P3002

“尝试的迁移已回滚:{database_error}”

P3003

“迁移的格式已更改,保存的迁移不再有效。要解决此问题,请按照以下步骤操作:https://pris.ly/d/migrate

P3004

{database_name} 数据库是系统数据库,不应使用 prisma migrate 进行修改。请连接到另一个数据库。”

P3005

“数据库模式不为空。了解更多关于如何为现有生产数据库建立基线的信息:https://pris.ly/d/migrate-baseline

P3006

“迁移 {migration_name} 未能干净地应用于影子数据库。
{error_code}错误
{inner_error}”

P3007

“请求的某些预览功能尚不允许在 schema engine 中使用。在使用迁移之前,请从数据模型中删除它们。(被阻止:{list_of_blocked_features})”

P3008

“迁移 {migration_name} 已在数据库中记录为已应用。”

P3009

“migrate 在目标数据库中发现失败的迁移,新的迁移将不会被应用。了解更多关于如何在生产数据库中解决迁移问题的信息:https://pris.ly/d/migrate-resolve
{details}”

P3010

“迁移的名称太长。长度不得超过 200 个字符(字节)。”

P3011

“迁移 {migration_name} 无法回滚,因为它从未应用于数据库。提示:你是否传入了完整的迁移名称?(例如:“20201207184859_initial_migration”)”

P3012

"迁移 {migration_name} 无法回滚,因为它不处于失败状态。"

P3013

"migrate 中不再支持数据源提供程序数组。请更改数据源以使用单个提供程序。请访问 https://pris.ly/multi-provider-deprecation 了解更多信息。"

P3014

"Prisma Migrate 无法创建影子数据库。请确保数据库用户具有创建数据库的权限。请访问 https://pris.ly/d/migrate-shadow 了解关于影子数据库(和解决方法)的更多信息。

原始错误:{error_code}
{inner_error}”

P3015

"在 {migration_file_path} 找不到迁移文件。请删除该目录或恢复迁移文件。"

P3016

"数据库重置的备用方法失败,这意味着 Migrate 无法完全清理数据库。原始错误:{error_code}
{inner_error}”

P3017

"找不到迁移 {migration_name}。请确保该迁移存在,并且您包含了目录的完整名称。(例如:“20201207184859_initial_migration”)"

P3018

"一个迁移应用失败。在错误恢复之前,无法应用新的迁移。请访问 https://pris.ly/d/migrate-resolve 了解有关如何在生产数据库中解决迁移问题的更多信息"

迁移名称:{migration_name}

数据库错误代码:{database_error_code}

数据库错误
{database_error} "

P3019

"您的 schema 中指定的数据源提供程序 {provider} 与 migration_lock.toml 中指定的 {expected_provider} 不匹配。请删除您当前的迁移目录,并使用 prisma migrate dev 开始新的迁移历史记录。请访问 https://pris.ly/d/migrate-provider-switch 了解更多信息。"

P3020

"在 Azure SQL 上,已禁用影子数据库的自动创建。请使用 shadowDatabaseUrl 数据源属性设置影子数据库。
请阅读文档页面了解更多详情:https://pris.ly/d/migrate-shadow"

P3021

"无法在此数据库上创建外键。请访问 https://pris.ly/d/migrate-no-foreign-keys 了解如何处理此问题。"

P3022

"在此数据库上禁用直接执行 DDL(数据定义语言)SQL 语句。请在此处阅读更多有关如何处理此问题的信息:https://pris.ly/d/migrate-no-direct-ddl"

prisma db pull

P4000

"内省操作未能生成 schema 文件:{introspection_error}"

P4001

"内省的数据库为空。"

P4002

"内省的数据库的 schema 不一致:{explanation}"

Prisma Accelerate

与 Prisma Accelerate 相关的错误以 P6xxx 开头,除了 P5011

P6000 (ServerError)

用于捕获所有其他错误的通用错误。

P6001 (InvalidDataSource)

URL 格式不正确;例如,它没有使用 prisma:// 协议。

P6002 (Unauthorized)

连接字符串中的 API 密钥无效。

P6003 (PlanLimitReached)

当前计划的包含使用量已超出。这只能在 免费计划 中发生。

P6004 (QueryTimeout)

已超出 Accelerate 的全局超时。您可以在此处找到限制。

另请参阅故障排除指南了解更多信息。

P6005 (InvalidParameters)

用户提供了无效的参数。目前仅与事务方法相关。例如,设置过高的超时。您可以在此处找到限制。

P6006 (VersionNotSupported)

选择的 Prisma 版本与 Accelerate 不兼容。当用户使用我们偶尔会修剪的不稳定开发版本时,可能会发生这种情况。

P6008 (ConnectionError|EngineStartError)

引擎启动失败。例如,它无法建立与数据库的连接。

另请参阅故障排除指南了解更多信息。

P6009 (ResponseSizeLimitExceeded)

已超出 Accelerate 的全局响应大小限制。您可以在此处找到限制。

另请参阅故障排除指南了解更多信息。

P6010 (ProjectDisabledError)

您的 accelerate 项目已禁用。请再次启用它以使用它。

P5011 (Too Many Requests)

此错误表示请求量已超出。实施退避策略,稍后再试。如需有关预期高工作负载的帮助,请联系支持

Prisma Pulse

与 Prisma Pulse 相关的错误以 P61xx 开头。

P6100 (ServerError) – HTTP 状态 500

发生意外的服务器错误。这可能是由于 Prisma Pulse 或其基础设施内的技术问题引起的。对于任何与 Prisma Pulse 相关的事件,您可以参考我们的状态页面 此处,并通过我们提供的渠道之一联系我们的支持团队来报告您的问题。

P6101 (DatasourceError) – HTTP 状态 400

原因

  1. Prisma Pulse 无法访问数据源。启用 Pulse 时,控制台将验证连接,以减少此错误的发生可能性。但是,数据源可能在配置步骤后变得不可用,从而导致此错误。
  2. 数据源可访问,但未满足 Prisma Pulse 的要求。启用 Pulse 时,控制台将验证配置,以减少此错误的发生可能性。但是,数据源可能会在配置步骤后更改,从而导致此错误。

P6102 (Unauthorized) – HTTP 状态码 400

API 密钥无效。

P6103 (ProjectDisabledError) – HTTP 状态码 400

为配置的 API 密钥未启用 Prisma Pulse。

P6104 (AccountHoldError) – HTTP 状态码 400

您的 Prisma Data Platform 帐户已被阻止,可能是由于超出您当前计划中包含的使用限制。请查看错误消息以获取更多信息。

如果您需要进一步的帮助,请通过我们的支持渠道之一与我们联系。

P6105 (VersionNotSupported) – HTTP 状态码 400

该项目的 Prisma 版本与 Prisma Pulse 不兼容。