HTTP 访问服务错误码
使用云开发时，您可能会遇到各种报错，本章节将为您介绍常见的错误码，以及如何解决。
通用错误
| 错误码 | 含义 |
|---|---|
| BAD_REQUEST | 请求数据或参数格式非法，请检查访问域名或 Host 是否正确填写，请求头和请求体是否正常设置 |
| INVALID_REQUEST | HTTP 请求不符合协议规范，或请求参数异常 |
| ENV_ABNORMAL | 环境状态异常，请检查云托管服务、版本状态是否正常 |
| INVALID_ENV | 环境 ID 非法或没有找到对应的云开发环境 |
| ENV_NOT_READY | 环境资源尚未准备完毕，请检查环境是否初始化完成 |
| ENV_FEATURE_NOT_CONFIGURED | 环境中不存在访问的目标资源 |
| INVALID_HOST | 无效或者非法的主机名，可能是域名填写错误或 DNS 解析问题 |
| INVALID_PATH | 未找到匹配的转发规则，请检查 HTTP 访问服务转发规则配置 |
| SERVICE_FORBIDDEN | 服务被禁用，可能是权限关闭、环境异常或微信云托管启动中 |
| HTTPSERVICE_NONACTIVATED | 未开启 HTTP 访问服务 |
| EXCEED_RATELIMIT | 请求速率超过所购买套餐的 QPS 配额 |
| EXCEED_MAX_PAYLOAD_SIZE | 请求体大小超过限制（云函数 6MB，其他 100MB） |
| BAD_GATEWAY | 网关传输过程中出现错误，请求转发失败 |
| ERR_ABORT_HANDLER | 请求处理中断，常见于大模型调用或 SSE 连接问题 |
| DEFAULT_DOMAIN_EXPIRED | 默认域名已超过使用有效期，需要续期或绑定自定义域名 |
鉴权和认证错误
| 错误码 | 含义 |
|---|---|
| MISSING_CREDENTIALS | 请求头中缺少必要的身份鉴权信息 |
| INVALID_CREDENTIALS | 身份认证失败，用户信息校验失败 |
| ACCESS_TOKEN_EXPIRED | 请求头中身份认证信息过期 |
| ACCESS_TOKEN_INVALID | 请求头中身份认证信息无效 |
| ACTION_FORBIDDEN | 当前身份无权限执行该操作 |
| UNSUPPORTED_AUTH_TYPE | 请求使用了不支持的认证类型 |
| AUTHENTICATION_FAILED | 请求鉴权失败 |
云托管相关错误
| 错误码 | 含义 |
|---|---|
| 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 | 云托管服务处于未就绪状态，可能正在冷启动 |
| 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 | 对象已经存在，无法执行指定操作 |
| OBJECT_BATCH_TOO_LARGE | 单次批量操作的对象数量过多 |
| 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 | 模型已停用 |
| EXCEED_CONCURRENT_REQUEST_LIMIT | 调用大模型超出并发限制 |
| EXCEED_TOKEN_QUOTA_LIMIT | 大模型 Token 用量已超出配额 |
系统错误
| 错误码 | 含义 |
|---|---|
| INTERNAL_REQUEST_FAIL | 系统内部请求错误 |
| SYS_ERR | 系统内部错误 |