跳到主要内容

HTTP 访问服务错误码

提示

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

通用错误​

BAD_REQUEST​

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

ENV_ABNORMAL​

环境状态异常，可尝试新建服务版本。

INVALID_ENV_ID​

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

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​

请求体大小超过限制，云函数请求体超出最大体积限制（文本 100 KB，其他 6 MB）。

BAD_GATEWAY​

网关传输过程中出现错误，当前仅云托管场景会出现此错误码。请求转发到云托管服务或从云托管接收响应过程中失败，请检查云托管服务负载是否正常，或检查客户端或服务日志。

EXCEED_CONCURRENT_REQUEST_LIMIT​

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

EXCEED_TOKEN_QUOTA_LIMIT​

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

ERR_ABORT_HANDLER​

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

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

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

鉴权和认证错误​

MISSING_CREDENTIALS​

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

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

INVALID_CREDENTIALS​

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

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

ACCESS_TOKEN_EXPIRED​

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

ACCESS_TOKEN_INVALID​

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

云托管相关错误​

SERVICE_NOT_FOUND​

未找到对应的云托管服务，请检查服务是否存在。

SERVICE_RESOURCE_NOT_FOUND​

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

SERVICE_VERSION_NOT_FOUND​

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

SERVICE_ENDPOINT_NOT_FOUND​

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

SERVICE_LB_STATUS_ABNORMAL​

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

SERVICE_CHARGE_OVERDUE​

欠费停机，请及时充值。

SERVICE_NOT_READY​

上游云托管服务处于未就绪状态，服务节点可能已经缩容到 0 或服务版本正在冷启动中，还未能提供正常访问，可稍等片刻再试。

SERVICE_TIMEOUT​

调用云托管服务超时，可查看云托管服务日志进行排查。

云函数相关错误​

FUNCTION_NOT_FOUND​

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

FUNCTION_INVOCATION_FAILED​

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

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

静态托管相关错误​

STATIC_RESOURCE_NONACTIVATED​

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

STATIC_RESOURCE_TOO_MANY_REDIRECTS​

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

STATIC_RESOURCE_REQUESTS_FAILED​

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

系统错误​

INTERNAL_REQUEST_FAIL​

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

SYS_ERR​

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