跳到主要内容

HTTP 访问服务错误码

提示

🌟 遇到 HTTP 访问问题？ 点击 这里 咨询云开发 Copilot，随时为你解答疑惑。📱 微信云开发用户请选择小程序公众号登录

通用错误​

BAD_REQUEST​

请求数据或参数格式非法，请检查访问域名或 Host 是否正确填写，请求头和请求体是否正常设置。

INVALID_REQUEST​

HTTP 请求不符合协议规范，或请求参数异常。请检查请求格式。

ENV_ABNORMAL​

环境状态异常，请到控制台上检查环境状态。如访问云托管服务，请检查云托管服务、版本状态是否正常，并尝试新建服务版本。

INVALID_ENV​

环境 ID 非法或没有找到对应的云开发环境，请检查访问域名是否正确。

ENV_NOT_READY​

环境资源尚未准备完毕，请到控制台上检查环境是否初始化完成，或稍等片刻再试。

ENV_FEATURE_NOT_CONFIGURED​

环境中不存在访问的目标资源，请到控制台上检查目标资源是否存在，或稍等片刻再试。

INVALID_HOST​

无效或者非法的主机名，原因可能是：

  1. 访问域名或 Host 未正确填写；
  2. 请求的域名既不是 CloudBase 合法的默认域名，也不是绑定的自定义域名；
  3. 请求的域名为自定义域名，但是未配置正确的 DNS 解析；
  4. 请求的域名为自定义域名，但是修改了 DNS 解析，还未生效。

可检查域名是否填写正确、是否配置了正确的 DNS 解析，如修改了 DNS 解析，请到域名服务商处查看解析是否生效，或稍等片刻再试。

INVALID_PATH​

未找到匹配的转发规则，请检查 HTTP 访问服务转发规则配置。

SERVICE_FORBIDDEN​

服务被禁用，原因可能是：

  1. HTTP 访问路径权限被关闭，服务禁止访问。如果想打开相关权限，请前往 云开发平台 操作；
  2. 服务或环境状态不正常，请检查环境是否欠费或被冻结；
  3. 使用微信云托管时，服务首次部署成功后，存在 1-3 分钟的启动时间，可等待后再次尝试。
  4. 使用微信云托管资源复用时，携带了不正确的签名信息。

HTTPSERVICE_NONACTIVATED​

未开启 HTTP 访问服务，请到 云开发平台 开启服务。 如果已开启服务，请稍后再试。

EXCEED_RATELIMIT​

请求速率超过所购买套餐的 QPS 配额，您可以通过升级套餐来提高 QPS 配额。

EXCEED_MAX_PAYLOAD_SIZE​

请求体大小超过限制。请求体大小限制如下：

  1. 云函数请求体最大限制：文本类型请求体 100KB，其他类型请求体 6MB；
  2. 其他请求的请求体最大限制 100MB。

BAD_GATEWAY​

网关传输过程中出现错误。请求转发到目标服务或从目标服务接收响应的过程中失败，请稍等片刻再试。如在访问云托管服务的过程中出现该报错，请检查云托管服务运行状况是否正常，或检查客户端或服务日志。

ERR_ABORT_HANDLER​

该错误的出现有多种原因，若在调用大模型的过程中出现该错误，请尝试以下解决方法：

  1. 确保使用流式输出（Server-sent Event）的请求在请求头 Accept 中包含 text/event-stream，否则请求将在 60 秒后超时；
  2. 确保 SSE (Server-sent Event) 响应持续返回数据，避免连接长时间空闲（超过 60 秒）被关闭。可以在 SSE 连接中通过注释行（comment line）进行定时心跳保活，例如 : ping。详见：事件流格式。

若在云托管（函数型）的响应中出现该错误，可尝试重新部署托管服务以升级到内置 SSE 保活的最新框架版本。

DEFAULT_DOMAIN_EXPIRED​

应安全合规要求，默认域名仅限开发测试使用，当前默认域名已经超过使用有效期，请在云开发平台上点击续期，续期预计 5 分钟内生效。 建议绑定自定义域名使用，避免因平台默认域名可访问性降低带来的服务可用性隐患。

鉴权和认证错误​

MISSING_CREDENTIALS​

请求头中缺少必要的身份鉴权信息，原因可能是：

  1. 开启了 HTTP 访问鉴权，但是请求头中没有鉴权信息，请参考 HTTP 访问鉴权。
  2. 使用开放 API 访问，但是请求头中没有鉴权信息，请参考 接入指南。

INVALID_CREDENTIALS​

身份认证失败，原因可能是：

  1. 开启 HTTP 访问鉴权的情况下，请求头中的用户信息校验失败，请参考 HTTP 访问鉴权。
  2. 使用开放 API 访问，请求头中的用户信息校验失败，请参考 接入指南。

ACCESS_TOKEN_EXPIRED​

请求头中身份认证信息过期，请重新获取认证信息。

ACCESS_TOKEN_INVALID​

请求头中身份认证信息无效，请检查身份认证信息的格式，或重新获取认证信息。

ACTION_FORBIDDEN​

请求头中对应的身份无权限执行当前操作，请检查当前身份是否有权限执行该操作，或在云开发平台-扩展能力-云后台管理-权限控制-策略管理更新当前角色关联的访问策略。

UNSUPPORTED_AUTH_TYPE​

请求使用了不支持的认证类型。如访问 HTTP API，请检查是否使用 AccessToken 或腾讯云签名 V3 认证。

AUTHENTICATION_FAILED​

请求鉴权失败，请稍等片刻再试，或提交工单给我们。

云托管相关错误​

SERVICE_NOT_FOUND​

未找到对应的云托管服务，请检查服务是否存在。如新创建服务，可稍等 2 分钟再试。

SERVICE_RESOURCE_NOT_FOUND​

未找到对应的资源，请检查服务和版本状态是否正常，或新建版本。

SERVICE_VERSION_NOT_FOUND​

找不到匹配的云托管服务版本，原因可能是没有创建云托管服务的版本，或新创建的版本还未生效，可稍等片刻再试。

SERVICE_ENDPOINT_NOT_FOUND​

找不到云托管服务可用的上游地址，原因可能是云托管的所有版本流量均被设置为零。

SERVICE_LB_STATUS_ABNORMAL​

云托管负载均衡状态异常，可尝试新建版本。

SERVICE_CHARGE_OVERDUE​

欠费停机，请及时充值。

SERVICE_NOT_READY​

云托管服务处于未就绪状态，服务节点可能已经缩容到 0 或服务版本正在冷启动中，未能提供正常访问，可稍等片刻再试。如需使云托管服务最少有 1 个节点，请参考 云托管服务运行模式与扩缩容 调整服务运行配置。

SERVICE_TIMEOUT​

云托管服务响应超时，可查看云托管服务日志进行排查，并在代码关键路径中增加耗时日志打印，优化耗时长步骤。

云函数相关错误​

FUNCTION_NOT_FOUND​

未找到对应的云函数，请检查云函数是否存在。

FUNCTION_INVOCATION_FAILED​

调用云函数超时或者失败，请确认云函数自身逻辑是否存在问题。

错误信息中可能会包含云函数报错的堆栈信息，您也可以通过 云函数日志 来查询错误信息。

FUNCTION_QUALIFIER_NOT_FOUND​

指定访问的函数版本不存在。请到控制台上检查函数版本是否存在，或检查请求指定版本是否正确。

FUNCTION_STATUS_ABNORMAL​

函数状态异常。请到控制台上检查函数状态。

FUNCTION_TIME_LIMIT_EXCEEDED​

函数执行超时，请检查函数是否有耗时长逻辑，或在控制台上调整函数超时时间。

FUNCTION_MEMORY_LIMIT_EXCEEDED​

函数执行内存超出限制，请检查函数代码相关逻辑，或在控制台上调整函数内存配置。

FUNCTION_EXECUTE_FAIL​

执行函数失败，请检查调用函数参数是否正确，排查函数逻辑，或通过 云函数日志 来查询错误信息。

FUNCTION_PARAM_INVALID​

调用函数的参数异常，请检查函数调用参数。

FUNCTION_EXCEED_RESOURCE_LIMIT​

请求频率超过函数预置并发，请降低请求频率，或在控制台上新增函数预置并发。

静态托管相关错误​

STATIC_RESOURCE_NONACTIVATED​

未开启静态网站托管服务，请到控制台上开启服务。

STATIC_RESOURCE_TOO_MANY_REDIRECTS​

请求重定向次数过多，请检查静态托管服务配置是否存在重定向死循环。

STATIC_RESOURCE_REQUESTS_FAILED​

请求静态托管资源失败，请稍后再试或提交工单给我们。

云存储相关错误​

STORAGE_EXCEED_AUTHORITY​

无权限对此对象执行对应操作。请检查存储桶权限设置和当前请求关联的用户身份是否具有对应权限。

OBJECT_NOT_EXIST​

请求的对象不存在，无法执行指定操作。

OBJECT_ALREADY_EXIST​

对象已经存在，无法执行指定操作。

COS_ACTION_FAILED​

对象存储操作执行失败，请稍等片刻再试。

CDN_SIGNATURE_MISSING​

当前访问链接的签名缺失，请检查链接是否携带了正确的签名参数。

CDN_INVALID_SIGNATURE​

当前访问链接的签名不正确，请检查链接携带的签名参数市是否正确。

CDN_SIGNATURE_EXPIRED​

当前访问链接的签名已过期，请重新生成签名。

大模型调用相关错误​

AI_MODEL_NOT_FOUND​

未找到指定模型分组，请检查请求参数，并到控制台上检查对应分组是否存在。如为新创建分组，请稍等片刻再试。

AI_MODEL_CONFIG_MISSING​

缺少 API Key 等调用模型的必要配置，请在控制台上补充配置。增加配置后，请稍等片刻再试。

AI_MODEL_REQUEST_FAILED​

请求大模型失败。请参考目标大模型文档检查调用模型参数是否正确，或参考 日志监控 查询对应调用的详细信息。

AI_MODEL_DISABLED​

模型已停用，请在控制台上检查模型是否启用，或稍等 2 分钟再试。

EXCEED_CONCURRENT_REQUEST_LIMIT​

调用大模型超出并发限制，请稍等片刻再试，或提交工单申请提高并发。

EXCEED_TOKEN_QUOTA_LIMIT​

大模型 Token 用量已超出配额，请购买资源包以提升配额。

系统错误​

INTERNAL_REQUEST_FAIL​

系统内部请求错误，请稍后再试或提交工单给我们。

SYS_ERR​

系统内部错误，请提交工单给我们。