错误消息参考
有关如何使用异常和错误代码的更多信息,请参阅 处理异常和错误。
Prisma Client 错误类型
Prisma Client 抛出不同类型的错误。以下列出异常类型及其文档化的数据字段
PrismaClientKnownRequestError
如果查询引擎返回与请求相关的已知错误(例如,唯一约束冲突),则 Prisma Client 抛出 PrismaClientKnownRequestError
异常。
属性 | 描述 |
---|---|
code | 一个 Prisma 特定的 错误代码。 |
meta | 有关错误的附加信息 - 例如,导致错误的字段:{ target: [ 'email' ] } |
message | 与 错误代码 关联的错误消息。 |
clientVersion | Prisma Client 的版本(例如,2.19.0 ) |
PrismaClientUnknownRequestError
如果查询引擎返回与没有错误代码的请求相关的错误,则 Prisma Client 抛出 PrismaClientUnknownRequestError
异常。
属性 | 描述 |
---|---|
message | 与 错误代码 关联的错误消息。 |
clientVersion | Prisma Client 的版本(例如,2.19.0 ) |
PrismaClientRustPanicError
如果底层引擎崩溃并以非零退出代码退出,则 Prisma Client 抛出 PrismaClientRustPanicError
异常。在这种情况下,必须重新启动 Prisma Client 或整个 Node 进程。
属性 | 描述 |
---|---|
message | 与 错误代码 关联的错误消息。 |
clientVersion | Prisma Client 的版本(例如,2.19.0 ) |
PrismaClientInitializationError
如果在启动查询引擎并创建与数据库的连接时出现问题,则 Prisma Client 抛出 PrismaClientInitializationError
异常。这会在以下情况下发生
- 当调用
prisma.$connect()
时 OR - 当执行第一个查询时
可能发生的错误包括
- 提供的数据库凭据无效
- 在提供的主机名和端口下没有正在运行的数据库服务器
- 查询引擎 HTTP 服务器要绑定的端口已被占用
- 缺少或无法访问的环境变量
- 找不到当前平台的查询引擎二进制文件(
generator
块)
属性 | 描述 |
---|---|
errorCode | 一个 Prisma 特定的错误代码。 |
message | 与 错误代码 关联的错误消息。 |
clientVersion | Prisma Client 的版本(例如,2.19.0 ) |
PrismaClientValidationError
如果验证失败,则 Prisma Client 抛出 PrismaClientValidationError
异常 - 例如
- 缺少字段 - 例如,在创建新记录时为空的
data: {}
属性 - 提供了不正确的字段类型(例如,将
Boolean
字段设置为"Hello, I like cheese and gold!"
)
属性 | 描述 |
---|---|
message | 错误消息。 |
clientVersion | Prisma 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
原因
- Prisma Pulse 无法访问数据源。启用 Pulse 时,控制台将验证连接,以减少此错误的发生可能性。但是,数据源可能在配置步骤后变得不可用,从而导致此错误。
- 数据源可访问,但未满足 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 不兼容。