错误码参考指南

Dapr 中的 gRPC 和 HTTP 错误码及其描述列表

以下表格列出了 Dapr 运行时返回的错误码。错误码在 HTTP 请求的响应体中返回，或在 gRPC 状态响应的 ErrorInfo 部分中返回（如果存在）。一项正在推进的工作是，根据 Richer Error Model 丰富所有 gRPC 错误响应。尚无对应 gRPC 代码的错误码表示这些错误尚未更新到此模型。

Actors API

HTTP Code	gRPC Code	Description
`ERR_ACTOR_INSTANCE_MISSING`		缺少 actor 实例
`ERR_ACTOR_INVOKE_METHOD`		调用 actor 方法时出错
`ERR_ACTOR_RUNTIME_NOT_FOUND`		未找到 actor 运行时
`ERR_ACTOR_STATE_GET`		获取 actor 状态时出错
`ERR_ACTOR_STATE_TRANSACTION_SAVE`		保存 actor 事务时出错
`ERR_ACTOR_REMINDER_CREATE`		创建 actor reminder 时出错
`ERR_ACTOR_REMINDER_DELETE`		删除 actor reminder 时出错
`ERR_ACTOR_REMINDER_GET`		获取 actor reminder 时出错
`ERR_ACTOR_REMINDER_NON_HOSTED`		在非托管 actor 类型上执行 reminder 操作
`ERR_ACTOR_TIMER_CREATE`		创建 actor timer 时出错
`ERR_ACTOR_NO_APP_CHANNEL`		应用通道未初始化
`ERR_ACTOR_STACK_DEPTH`		超出最大 actor 调用栈深度
`ERR_ACTOR_NO_PLACEMENT`		未配置 Placement 服务
`ERR_ACTOR_RUNTIME_CLOSED`		Actor 运行时已关闭
`ERR_ACTOR_NAMESPACE_REQUIRED`		在 Kubernetes 模式下运行时，actor 必须配置命名空间
`ERR_ACTOR_NO_ADDRESS`		未找到 actor 的地址

工作流 API

HTTP Code	gRPC Code	Description
`ERR_GET_WORKFLOW`		获取工作流时出错
`ERR_START_WORKFLOW`		启动工作流时出错
`ERR_PAUSE_WORKFLOW`		暂停工作流时出错
`ERR_RESUME_WORKFLOW`		恢复工作流时出错
`ERR_TERMINATE_WORKFLOW`		终止工作流时出错
`ERR_PURGE_WORKFLOW`		清除工作流时出错
`ERR_RAISE_EVENT_WORKFLOW`		在工作流中引发事件时出错
`ERR_WORKFLOW_COMPONENT_MISSING`		缺少工作流组件
`ERR_WORKFLOW_COMPONENT_NOT_FOUND`		未找到工作流组件
`ERR_WORKFLOW_EVENT_NAME_MISSING`		缺少工作流事件名称
`ERR_WORKFLOW_NAME_MISSING`		未配置工作流名称
`ERR_INSTANCE_ID_INVALID`		工作流实例 ID 无效。（仅允许字母数字和下划线字符）
`ERR_INSTANCE_ID_NOT_FOUND`		未找到工作流实例 ID
`ERR_INSTANCE_ID_PROVIDED_MISSING`		缺少工作流实例 ID
`ERR_INSTANCE_ID_TOO_LONG`		工作流实例 ID 过长

状态管理 API

HTTP Code	gRPC Code	Description
`ERR_STATE_TRANSACTION`		状态事务出错
`ERR_STATE_SAVE`		保存状态时出错
`ERR_STATE_GET`		获取状态时出错
`ERR_STATE_DELETE`		删除状态时出错
`ERR_STATE_BULK_DELETE`		批量删除状态时出错
`ERR_STATE_BULK_GET`		批量获取状态时出错
`ERR_NOT_SUPPORTED_STATE_OPERATION`		事务中不支持该操作
`ERR_STATE_QUERY`	`DAPR_STATE_QUERY_FAILED`	查询状态时出错
`ERR_STATE_STORE_NOT_FOUND`	`DAPR_STATE_NOT_FOUND`	未找到状态存储
`ERR_STATE_STORE_NOT_CONFIGURED`	`DAPR_STATE_NOT_CONFIGURED`	状态存储未配置
`ERR_STATE_STORE_NOT_SUPPORTED`	`DAPR_STATE_TRANSACTIONS_NOT_SUPPORTED`	状态存储不支持事务
`ERR_STATE_STORE_NOT_SUPPORTED`	`DAPR_STATE_QUERYING_NOT_SUPPORTED`	状态存储不支持查询
`ERR_STATE_STORE_TOO_MANY_TRANSACTIONS`	`DAPR_STATE_TOO_MANY_TRANSACTIONS`	单个事务中的操作数过多
`ERR_MALFORMED_REQUEST`	`DAPR_STATE_ILLEGAL_KEY`	键无效

Configuration API

HTTP Code	gRPC Code	Description
`ERR_CONFIGURATION_GET`		获取配置时出错
`ERR_CONFIGURATION_STORE_NOT_CONFIGURED`		配置存储未配置
`ERR_CONFIGURATION_STORE_NOT_FOUND`		未找到配置存储
`ERR_CONFIGURATION_SUBSCRIBE`		订阅配置时出错
`ERR_CONFIGURATION_UNSUBSCRIBE`		取消订阅配置时出错

密码学 API

HTTP Code	gRPC Code	Description
`ERR_CRYPTO`		密码学操作出错
`ERR_CRYPTO_KEY`		获取密码学密钥时出错
`ERR_CRYPTO_PROVIDER_NOT_FOUND`		未找到密码学提供程序
`ERR_CRYPTO_PROVIDERS_NOT_CONFIGURED`		密码学提供程序未配置

Secrets API

HTTP Code	gRPC Code	Description
`ERR_SECRET_GET`		获取 secret 时出错
`ERR_SECRET_STORE_NOT_FOUND`		未找到 secret 存储
`ERR_SECRET_STORES_NOT_CONFIGURED`		Secret 存储未配置
`ERR_PERMISSION_DENIED`		策略拒绝权限

发布订阅和消息错误

HTTP Code	gRPC Code	Description
`ERR_PUBSUB_EMPTY`	`DAPR_PUBSUB_NAME_EMPTY`	Pubsub 名称为空
`ERR_PUBSUB_NOT_FOUND`	`DAPR_PUBSUB_NOT_FOUND`	未找到 Pubsub
`ERR_PUBSUB_NOT_FOUND`	`DAPR_PUBSUB_TEST_NOT_FOUND`	未找到 Pubsub
`ERR_PUBSUB_NOT_CONFIGURED`	`DAPR_PUBSUB_NOT_CONFIGURED`	Pubsub 未配置
`ERR_TOPIC_NAME_EMPTY`	`DAPR_PUBSUB_TOPIC_NAME_EMPTY`	主题名称为空
`ERR_PUBSUB_FORBIDDEN`	`DAPR_PUBSUB_FORBIDDEN`	应用 ID 被禁止访问主题
`ERR_PUBSUB_PUBLISH_MESSAGE`	`DAPR_PUBSUB_PUBLISH_MESSAGE`	发布消息时出错
`ERR_PUBSUB_REQUEST_METADATA`	`DAPR_PUBSUB_METADATA_DESERIALIZATION`	反序列化元数据时出错
`ERR_PUBSUB_CLOUD_EVENTS_SER`	`DAPR_PUBSUB_CLOUD_EVENT_CREATION`	创建 CloudEvent 时出错
`ERR_PUBSUB_EVENTS_SER`	`DAPR_PUBSUB_MARSHAL_ENVELOPE`	封送 Cloud Event 信封时出错
`ERR_PUBSUB_EVENTS_SER`	`DAPR_PUBSUB_MARSHAL_EVENTS`	将事件封送为字节时出错
`ERR_PUBSUB_EVENTS_SER`	`DAPR_PUBSUB_UNMARSHAL_EVENTS`	反封送事件时出错
`ERR_PUBLISH_OUTBOX`		向 outbox 发布消息时出错

对话 API

HTTP Code	gRPC Code	Description
`ERR_CONVERSATION_INVALID_PARMS`		对话组件参数无效
`ERR_CONVERSATION_INVOKE`		调用对话时出错
`ERR_CONVERSATION_MISSING_INPUTS`		缺少对话输入
`ERR_CONVERSATION_NOT_FOUND`		未找到对话

服务调用 / 直接消息 API

HTTP Code	gRPC Code	Description
`ERR_DIRECT_INVOKE`		调用服务时出错

Bindings API

HTTP Code	gRPC Code	Description
`ERR_INVOKE_OUTPUT_BINDING`		调用输出绑定时出错

分布式锁 API

HTTP Code	gRPC Code	Description
`ERR_LOCK_STORE_NOT_CONFIGURED`		锁存储未配置
`ERR_LOCK_STORE_NOT_FOUND`		未找到锁存储
`ERR_TRY_LOCK`		获取锁时出错
`ERR_UNLOCK`		释放锁时出错

健康检查

HTTP Code	gRPC Code	Description
`ERR_HEALTH_NOT_READY`		Dapr 未就绪
`ERR_HEALTH_APPID_NOT_MATCH`		Dapr App ID 不匹配
`ERR_OUTBOUND_HEALTH_NOT_READY`		Dapr 出站未就绪

通用

HTTP Code	gRPC Code	Description
`ERR_API_UNIMPLEMENTED`		API 未实现
`ERR_APP_CHANNEL_NIL`		应用通道为 nil
`ERR_BAD_REQUEST`		错误请求
`ERR_BODY_READ`		读取请求体时出错
`ERR_INTERNAL`		内部错误
`ERR_MALFORMED_REQUEST`		格式错误的请求
`ERR_MALFORMED_REQUEST_DATA`		格式错误的请求数据
`ERR_MALFORMED_RESPONSE`		格式错误的响应

Scheduler/Jobs API

HTTP Code	gRPC Code	Description
`DAPR_SCHEDULER_SCHEDULE_JOB`	`DAPR_SCHEDULER_SCHEDULE_JOB`	调度任务时出错
`DAPR_SCHEDULER_JOB_NAME`	`DAPR_SCHEDULER_JOB_NAME`	作业名称只能设置在 URL 中
`DAPR_SCHEDULER_JOB_NAME_EMPTY`	`DAPR_SCHEDULER_JOB_NAME_EMPTY`	作业名称为空
`DAPR_SCHEDULER_GET_JOB`	`DAPR_SCHEDULER_GET_JOB`	获取任务时出错
`DAPR_SCHEDULER_LIST_JOBS`	`DAPR_SCHEDULER_LIST_JOBS`	列出任务时出错
`DAPR_SCHEDULER_DELETE_JOB`	`DAPR_SCHEDULER_DELETE_JOB`	删除任务时出错
`DAPR_SCHEDULER_EMPTY`	`DAPR_SCHEDULER_EMPTY`	必需参数为空
`DAPR_SCHEDULER_SCHEDULE_EMPTY`	`DAPR_SCHEDULER_SCHEDULE_EMPTY`	未提供任务的调度计划

通用

HTTP Code	gRPC Code	Description
`ERROR`	`ERROR`	通用错误

后续步骤