概述
使用云开发时，您可能会遇到各种报错，本章节将为您介绍常见的错误码，以及如何解决。
通用错误
登录认证错误
| 错误码 | 含义 |
|---|---|
| AUTH_INVALID_CUSTOM_LOGIN_TICKET | 自定义登录凭证非法（格式错误、过期、校验失败等） |
| AUTH_WX_OAUTH_FAILED | 微信 OAuth 失败 |
| AUTH_CUSTOM_USER_ID_HAS_BEEN_BOUND | CustomUserId 已关联帐户 |
| AUTH_OPEN_ID_HAS_BEEN_BOUND | openId 已关联帐户 |
| AUTH_UNION_ID_HAS_BEEN_BOUND | unionId 已关联帐户 |
| AUTH_EMAIL_HAS_BEEN_BOUND | email 已关联帐户 |
| INVALID_EMAIL_TOKEN | 邮箱激活 token 过期或者不存在 |
| AUTH_LOGIN_FAILED | 登录失败 |
| INVALID_ACCESS_TOKEN | 非法的访问令牌 |
| ACCESS_TOKEN_DISABLED | 访问令牌已禁用 |
| REFRESH_TOKEN_DISABLED | 刷新令牌已禁用 |
| PHONE_CODE_NOT_MATCHED | 手机验证码不匹配 |
| PHONE_CODE_NOTFOUND_OR_EXPIRED | 手机验证码未找到或已过期 |
| PHONE_CODE_SEND_LIMIT_EXCEED | 手机验证码发送次数超限 |
| MISSING_CREDENTIALS | 请求头中缺少必要的身份鉴权信息 |
| INVALID_CREDENTIALS | 身份认证失败，用户信息校验失败 |
| ACCESS_TOKEN_INVALID | 请求头中身份认证信息无效 |
| ACCESS_TOKEN_KID_INVALID | 访问令牌的 Key ID (kid) 无效 |
| ACTION_FORBIDDEN | 当前身份无权限执行该操作 |
| WX_WEBSOCKET_TOKEN_EXPIRED | 微信 WebSocket 连接的令牌已过期 |
| WX_HEADER_GET_FAILED | 获取微信请求头失败 |
| UNSUPPORTED_AUTH_TYPE | 请求使用了不支持的认证类型 |
| AUTHENTICATION_FAILED | 请求鉴权失败 |
数据库错误
| 错误码 | 含义 |
|---|---|
| DATABASE_REQUEST_FAILED | 数据库请求失败，数据库通用错误 |
| DATABASE_INVALID_OPERRATOR | 不支持的操作、非法的数据库操作符 |
| DATABASE_PERMISSION_DENIED | 无权限操作数据库资源 |
| DATABASE_COLLECTION_EXCEED_LIMIT | 数据库集合数量超限 |
| DATABASE_COLLECTION_NOT_EXIST | 操作集合不存在 |
| DATABASE_COLLECTION_ALREADY_EXIST | 创建集合的时候，集合已存在 |
| DATABASE_TIMEOUT | 数据库请求超时 |
| DATABASE_TRANSACTION_FAIL | 数据库事务请求失败 |
| DATABASE_TRANSACTION_CONFLICT | 数据库事务间冲突 |
| DATABASE_DUPLICATE_WRITE | 写数据库失败，索引键重复（例如插入相同 _id 的数据） |
云函数错误
| 错误码 | 含义 |
|---|---|
| FUNCTIONS_EXECUTE_FAIL | 云函数执行失败，云函数通用错误 |
| FUNCTIONS_TIME_LIMIT_EXCEEDED | 云函数执行超时 |
| FUNCTIONS_MEMORY_LIMIT_EXCEEDED | 云函数运行内存超限 |
| FUNCTION_NOT_FOUND | 云函数未找到 |
| FUNCTIONS_STATUS_ABNORMITY | 云函数状态异常 |
| 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 | 请求频率超过函数预置并发 |
云托管相关错误
| 错误码 | 含义 |
|---|---|
| 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 | 云托管服务响应超时 |
云存储错误
| 错误码 | 含义 |
|---|---|
| STORAGE_REQUEST_FAIL | 云存储请求失败，云存储通用错误 |
| EXCEED_UPLOAD_MAXFILESIZE | 云存储上传文件大小超限 |
| STORAGE_SIGN_PARAM_INVALID | 云存储文件元数据解析失败 |
| STORAGE_EXCEED_AUTHORITY | 当前用户无权限操作云存储资源 |
| STORAGE_FILE_NONEXIST | 云存储文件不存在 |
| STORAGE_FILE_PATH_CONFLICT | 云存储文件路径冲突 |
| OBJECT_NOT_EXIST | 请求的对象不存在，无法执行指定操作 |
| OBJECT_ALREADY_EXIST | 对象已经存在，无法执行指定操作 |
| OBJECT_BATCH_TOO_LARGE | 单次批量操作的对象数量过多 |
| COS_ACTION_FAILED | 对象存储操作执行失败 |
| CDN_SIGNATURE_MISSING | 当前访问链接的签名缺失 |
| CDN_INVALID_SIGNATURE | 当前访问链接的签名不正确 |
| CDN_SIGNATURE_EXPIRED | 当前访问链接的签名已过期 |
静态托管相关错误
| 错误码 | 含义 |
|---|---|
| STATIC_RESOURCE_NONACTIVATED | 未开启静态网站托管服务 |
| STATIC_RESOURCE_TOO_MANY_REDIRECTS | 请求重定向次数过多，可能存在重定向死循环 |
| STATIC_RESOURCE_REQUESTS_FAILED | 请求静态托管资源失败 |
大模型调用相关错误
| 错误码 | 含义 |
|---|---|
| AI_MODEL_NOT_FOUND | 未找到指定模型分组 |
| AI_MODEL_CONFIG_MISSING | 缺少 API Key 等调用模型的必要配置 |
| AI_MODEL_REQUEST_FAILED | 请求大模型失败 |
| AI_MODEL_DISABLED | 模型已停用 |
| EXCEED_TOKEN_QUOTA_LIMIT | 大模型 Token 用量已超出配额 |
| APIs_GET_OPENAPI_SCHEMA_ERROR | 获取 OpenAPI Schema 失败 |
注意
DATABASE_REQUEST_FAILED、STORAGE_REQUEST_FAIL、FUNCTIONS_EXECUTE_FAIL 分别为通用的数据库、云存储请求错误、云函数请求错误，无特殊的语义，未来将细化出独立特征语义的错误码，请避免基于该错误码进行特殊逻辑判断。