错误消息参考
有关如何处理异常和错误代码的更多信息，请参阅处理异常和错误。
Prisma Client 错误类型
Prisma Client 会抛出不同类型的错误。以下列出了异常类型及其文档化的数据字段
PrismaClientKnownRequestError
如果查询引擎返回与请求相关的已知错误（例如，唯一约束冲突），Prisma Client 会抛出 PrismaClientKnownRequestError 异常。
| 属性 | 描述 |
|---|---|
代码 | Prisma 特定的错误代码。 |
元数据 | 关于错误的附加信息——例如，导致错误的字段：{ target: [ 'email' ] } |
消息 | 与错误代码关联的错误消息。 |
客户端版本 | Prisma Client 版本（例如，2.19.0） |
PrismaClientUnknownRequestError
如果查询引擎返回与请求相关的、没有错误代码的错误，Prisma Client 会抛出 PrismaClientUnknownRequestError 异常。
| 属性 | 描述 |
|---|---|
消息 | 与错误代码关联的错误消息。 |
客户端版本 | Prisma Client 版本（例如，2.19.0） |
PrismaClientRustPanicError
如果底层引擎崩溃并以非零退出代码退出，Prisma Client 会抛出 PrismaClientRustPanicError 异常。在这种情况下，必须重新启动 Prisma Client 或整个 Node 进程。
| 属性 | 描述 |
|---|---|
消息 | 与错误代码关联的错误消息。 |
客户端版本 | Prisma Client 版本（例如，2.19.0） |
PrismaClientInitializationError
如果查询引擎启动和数据库连接创建过程中出现问题，Prisma Client 会抛出 PrismaClientInitializationError 异常。这通常发生在：
- 调用
prisma.$connect()时 或 - 执行第一个查询时
可能发生的错误包括：
- 提供的数据库凭据无效
- 在提供的 hostname 和端口下没有数据库服务器运行
- 查询引擎 HTTP 服务器要绑定的端口已被占用
- 缺少或无法访问的环境变量
- 找不到当前平台的查询引擎二进制文件（
generator块）
| 属性 | 描述 |
|---|---|
错误代码 | Prisma 特定的错误代码。 |
消息 | 与错误代码关联的错误消息。 |
客户端版本 | Prisma Client 版本（例如，2.19.0） |
PrismaClientValidationError
如果验证失败，Prisma Client 会抛出 PrismaClientValidationError 异常——例如
- 缺少字段——例如，创建新记录时
data: {}属性为空 - 提供了不正确的字段类型（例如，将
Boolean字段设置为"Hello, I like cheese and gold!"）
| 属性 | 描述 |
|---|---|
消息 | 错误消息。 |
客户端版本 | 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 版本之前有效的 Schema 在 4.0.0 及更高版本中可能无效。升级指南解释了如何更新您的 Schema 以使其有效。
"{full_error}"
可能的 P1012 错误消息
- "参数
{}缺失。" - "函数
{}需要个参数，但收到." - "属性
@{}中缺少参数{}。" - "数据源块
{}中缺少参数{}。" - "生成器块
{}中缺少参数{}。" - "解析属性
@{}时出错" - "属性
@{}已被定义两次。" - "无法定义数据库名为
{}的模型，因为已存在同名模型：{}" - "
{}是保留的标量类型名称，不能使用。" - 该 无法定义，因为已存在同名。
- 键
{}已在...中定义." - "参数
{}已被指定为未命名参数。" - "参数
{}已被指定。" - "无此参数。"
- "字段
{}已在模型{}上定义。" - "模型
{}中的字段{}不能是列表。当前连接器不支持原始类型列表。" - "索引名
{}被声明多次。在当前连接器下，索引名必须全局唯一。" - "值
{}已在枚举{}上定义。" - "未知属性：
@{}。" - "未知函数：
{}。" - "未知数据源提供者：
{}。" - "shadowDatabaseUrl 与数据源
{}的 url 相同。请指定一个不同的数据库作为影子数据库。" - "未知预览功能
{}。期望以下之一" - "
{}不是一个有效值，对于." - "类型
{}既不是内置类型，也不引用其他模型、自定义类型或枚举。" - "类型
{}不是内置类型。" - "意外的 token。期望以下之一"
- 环境变量未找到."
- 期望一个值，但收到值
{}。" - 期望一个值，但在解析
{}时失败." - "验证模型
{}时出错" - "验证模型
{}中字段{}时出错" - "验证数据源
{datasource}时出错: {message}" - "验证枚举
{}时出错" - 验证时出错"
P1013
"提供的数据库字符串无效。{details}"
P1014
"模型 {model} 的底层 {kind} 不存在。"
P1015
"您的 Prisma Schema 正在使用数据库版本不支持的功能。
数据库版本: {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_position} 处解析查询 {query_parsing_error} 失败"
P2009
"在 {query_position} 处验证查询 {query_validation_error} 失败"
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...]) 添加到您的 schema"
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 引擎)
Schema 引擎以前称为 Migration 引擎。此更改在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
"数据库 Schema 不为空。阅读更多关于如何基线现有生产数据库的信息: https://pris.ly/d/migrate-baseline"
P3006
"迁移 {migration_name} 未能干净地应用于影子数据库。
{error_code}错误
{inner_error}"
P3007
"Schema 引擎中尚不允许使用某些请求的预览功能。在使用迁移之前，请将其从数据模型中移除。(已阻止: {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 (服务器错误)
捕获所有其他错误的通用错误。
P6001 (无效数据源)
URL 格式错误；例如，它没有使用 prisma:// 协议。
P6002 (未经授权)
连接字符串中的 API 密钥无效。
P6003 (计划限制已达)
当前计划的包含使用量已超出。这仅在免费计划中可能发生。
P6004 (查询超时)
Accelerate 的全局超时已超出。您可以在此处找到该限制。
另请参阅故障排除指南以获取更多信息。
P6005 (无效参数)
用户提供了无效参数。目前仅与事务方法相关。例如，设置了过高的超时。您可以在此处找到该限制。
P6006 (不支持的版本)
所选的 Prisma 版本与 Accelerate 不兼容。当用户使用我们偶尔清理的不稳定开发版本时，可能会发生这种情况。
P6008 (连接错误|引擎启动错误)
引擎启动失败。例如，无法建立到数据库的连接。
另请参阅故障排除指南以获取更多信息。
P6009 (响应大小超出限制)
Accelerate 的全局响应大小限制已超出。您可以在此处找到该限制。
另请参阅故障排除指南以获取更多信息。
P6010 (项目已禁用错误)
您的 Accelerate 项目已禁用。请重新启用它才能使用。
P5011 (请求过多)
此错误表示请求量超出限制。请实施退避策略并稍后重试。如需高并发工作负载的帮助，请联系支持。