错误代码参考指南

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

以下表格列出了 Dapr 运行时返回的错误代码。 错误代码会在 HTTP 请求的响应体中或 gRPC 状态响应的 ErrorInfo 部分返回（如果存在）。 我们正在努力根据 更丰富的错误模型 来改进所有 gRPC 错误响应。没有对应 gRPC 代码的错误代码表示这些错误尚未更新到此模型。

演员 API

HTTP 代码gRPC 代码描述
ERR_ACTOR_INSTANCE_MISSING缺少演员实例
ERR_ACTOR_INVOKE_METHOD调用演员方法时发生错误
ERR_ACTOR_RUNTIME_NOT_FOUND找不到演员运行时
ERR_ACTOR_STATE_GET获取演员状态时发生错误
ERR_ACTOR_STATE_TRANSACTION_SAVE保存演员事务时发生错误
ERR_ACTOR_REMINDER_CREATE创建演员提醒时发生错误
ERR_ACTOR_REMINDER_DELETE删除演员提醒时发生错误
ERR_ACTOR_REMINDER_GET获取演员提醒时发生错误
ERR_ACTOR_REMINDER_NON_HOSTED非托管演员类型的提醒操作
ERR_ACTOR_TIMER_CREATE创建演员计时器时发生错误
ERR_ACTOR_NO_APP_CHANNEL应用通道未初始化
ERR_ACTOR_STACK_DEPTH超过演员调用堆栈的最大深度
ERR_ACTOR_NO_PLACEMENT未配置放置服务
ERR_ACTOR_RUNTIME_CLOSED演员运行时已关闭
ERR_ACTOR_NAMESPACE_REQUIRED在 Kubernetes 模式下运行时，演员必须配置命名空间
ERR_ACTOR_NO_ADDRESS找不到演员的地址

工作流 API

HTTP 代码gRPC 代码描述
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 代码gRPC 代码描述
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_QUERYDAPR_STATE_QUERY_FAILED查询状态时出错
ERR_STATE_STORE_NOT_FOUNDDAPR_STATE_NOT_FOUND找不到状态存储
ERR_STATE_STORE_NOT_CONFIGUREDDAPR_STATE_NOT_CONFIGURED未配置状态存储
ERR_STATE_STORE_NOT_SUPPORTEDDAPR_STATE_TRANSACTIONS_NOT_SUPPORTED状态存储不支持事务
ERR_STATE_STORE_NOT_SUPPORTEDDAPR_STATE_QUERYING_NOT_SUPPORTED状态存储不支持查询
ERR_STATE_STORE_TOO_MANY_TRANSACTIONSDAPR_STATE_TOO_MANY_TRANSACTIONS每个事务的操作过多
ERR_MALFORMED_REQUESTDAPR_STATE_ILLEGAL_KEY无效的键

配置 API

HTTP 代码gRPC 代码描述
ERR_CONFIGURATION_GET获取配置时出错
ERR_CONFIGURATION_STORE_NOT_CONFIGURED未配置配置存储
ERR_CONFIGURATION_STORE_NOT_FOUND找不到配置存储
ERR_CONFIGURATION_SUBSCRIBE订阅配置时出错
ERR_CONFIGURATION_UNSUBSCRIBE取消订阅配置时出错

加密 API

HTTP 代码gRPC 代码描述
ERR_CRYPTO加密操作出错
ERR_CRYPTO_KEY检索加密密钥时出错
ERR_CRYPTO_PROVIDER_NOT_FOUND找不到加密提供者
ERR_CRYPTO_PROVIDERS_NOT_CONFIGURED未配置加密提供者

密钥管理 API

HTTP 代码gRPC 代码描述
ERR_SECRET_GET获取密钥时出错
ERR_SECRET_STORE_NOT_FOUND找不到密钥存储
ERR_SECRET_STORES_NOT_CONFIGURED未配置密钥存储
ERR_PERMISSION_DENIED策略拒绝权限

发布/订阅和消息传递错误

HTTP 代码gRPC 代码描述
ERR_PUBSUB_EMPTYDAPR_PUBSUB_NAME_EMPTY发布/订阅名称为空
ERR_PUBSUB_NOT_FOUNDDAPR_PUBSUB_NOT_FOUND找不到发布/订阅
ERR_PUBSUB_NOT_FOUNDDAPR_PUBSUB_TEST_NOT_FOUND找不到发布/订阅
ERR_PUBSUB_NOT_CONFIGUREDDAPR_PUBSUB_NOT_CONFIGURED未配置发布/订阅
ERR_TOPIC_NAME_EMPTYDAPR_PUBSUB_TOPIC_NAME_EMPTY主题名称为空
ERR_PUBSUB_FORBIDDENDAPR_PUBSUB_FORBIDDEN禁止访问主题的应用 ID
ERR_PUBSUB_PUBLISH_MESSAGEDAPR_PUBSUB_PUBLISH_MESSAGE发布消息时出错
ERR_PUBSUB_REQUEST_METADATADAPR_PUBSUB_METADATA_DESERIALIZATION反序列化元数据时出错
ERR_PUBSUB_CLOUD_EVENTS_SERDAPR_PUBSUB_CLOUD_EVENT_CREATION创建 CloudEvent 时出错
ERR_PUBSUB_EVENTS_SERDAPR_PUBSUB_MARSHAL_ENVELOPE编组 Cloud Event 信封时出错
ERR_PUBSUB_EVENTS_SERDAPR_PUBSUB_MARSHAL_EVENTS将事件编组为字节时出错
ERR_PUBSUB_EVENTS_SERDAPR_PUBSUB_UNMARSHAL_EVENTS解组事件时出错
ERR_PUBLISH_OUTBOX将消息发布到 outbox 时出错

对话 API

HTTP 代码gRPC 代码描述
ERR_CONVERSATION_INVALID_PARMS对话组件的参数无效
ERR_CONVERSATION_INVOKE调用对话时出错
ERR_CONVERSATION_MISSING_INPUTS对话缺少输入
ERR_CONVERSATION_NOT_FOUND找不到对话

服务调用 / 直接消息传递 API

HTTP 代码gRPC 代码描述
ERR_DIRECT_INVOKE调用服务时出错

绑定 API

HTTP 代码gRPC 代码描述
ERR_INVOKE_OUTPUT_BINDING调用输出绑定时出错

分布式锁 API

HTTP 代码gRPC 代码描述
ERR_LOCK_STORE_NOT_CONFIGURED未配置锁存储
ERR_LOCK_STORE_NOT_FOUND找不到锁存储
ERR_TRY_LOCK获取锁时出错
ERR_UNLOCK释放锁时出错

健康检查

HTTP 代码gRPC 代码描述
ERR_HEALTH_NOT_READYDapr 未准备好
ERR_HEALTH_APPID_NOT_MATCHDapr 应用 ID 不匹配
ERR_OUTBOUND_HEALTH_NOT_READYDapr 出站未准备好

通用

HTTP 代码gRPC 代码描述
ERR_API_UNIMPLEMENTEDAPI 未实现
ERR_APP_CHANNEL_NIL应用通道为 nil
ERR_BAD_REQUEST错误请求
ERR_BODY_READ读取请求体时出错
ERR_INTERNAL内部错误
ERR_MALFORMED_REQUEST请求格式错误
ERR_MALFORMED_REQUEST_DATA请求数据格式错误
ERR_MALFORMED_RESPONSE响应格式错误

调度/作业 API

HTTP 代码gRPC 代码描述
DAPR_SCHEDULER_SCHEDULE_JOBDAPR_SCHEDULER_SCHEDULE_JOB调度作业时出错
DAPR_SCHEDULER_JOB_NAMEDAPR_SCHEDULER_JOB_NAME作业名称应仅在 URL 中设置
DAPR_SCHEDULER_JOB_NAME_EMPTYDAPR_SCHEDULER_JOB_NAME_EMPTY作业名称为空
DAPR_SCHEDULER_GET_JOBDAPR_SCHEDULER_GET_JOB获取作业时出错
DAPR_SCHEDULER_LIST_JOBSDAPR_SCHEDULER_LIST_JOBS列出作业时出错
DAPR_SCHEDULER_DELETE_JOBDAPR_SCHEDULER_DELETE_JOB删除作业时出错
DAPR_SCHEDULER_EMPTYDAPR_SCHEDULER_EMPTY必需的参数为空
DAPR_SCHEDULER_SCHEDULE_EMPTYDAPR_SCHEDULER_SCHEDULE_EMPTY未提供作业的调度

通用

HTTP 代码gRPC 代码描述
ERRORERROR通用错误

下一步