# 错误码

在使用云能力时抛出的异常（fail 回调 / Promise reject）`Error` 对象中会带有 `errCode` 和 `errMsg`，云开发 HTTP API 回包中也会带有`errcode`和`errmsg`，这里是 `errCode` 值的一览表。

| 错误码  | 含义                       |
|---------|----------------------------|
| -1      | 通用错误                   |
| -401001 | SDK 通用错误：无权限使用 API             |
| -401002 | SDK 通用错误：API 传入参数错误           |
| -401003 | SDK 通用错误：API 传入参数类型错误       |
| -402001 | SDK 数据库错误：检测到循环引用             |
| -402002 | SDK 数据库错误：初始化监听失败     |
| -402003 | SDK 数据库错误：重连 WebSocket 失败     |
| -402004 | SDK 数据库错误：重建监听失败     |
| -402005 | SDK 数据库错误：关闭监听失败     |
| -402006 | SDK 数据库错误：收到服务器错误信息     |
| -402007 | SDK 数据库错误：从服务器收到非法数据     |
| -402008 | SDK 数据库错误：WebSocket 连接异常     |
| -402009 | SDK 数据库错误：WebSocket 连接断开     |
| -402010 | SDK 数据库错误：检查包序失败     |
| -402011 | SDK 数据库错误：未知异常     |
| -501001 | 云资源通用错误：云端系统错误               |
| -403001 | SDK 文件存储错误：上传的文件超出大小上限     |
| -404001 | SDK 云函数错误：云函数调用内部失败：空回包             |
| -404002 | SDK 云函数错误：云函数调用内部失败：空 eventid             |
| -404003 | SDK 云函数错误：云函数调用内部失败：空 pollurl |
| -404004 | SDK 云函数错误：云函数调用内部失败：空 poll 结果 JSON |
| -404005 | SDK 云函数错误：云函数调用失败：超出最大正常结果轮询尝试次数 |
| -404006 | SDK 云函数错误：云函数调用内部失败：空 base resp |
| -404007 | SDK 云函数错误：云函数调用失败：baseresponse.errcode 非 0 |
| -404008 | SDK 云函数错误：云函数调用失败：v1 轮询状态码异常 |
| -404009 | SDK 云函数错误：云函数调用内部失败：轮询处理异常 |
| -404010 | SDK 云函数错误：云函数调用失败：轮询结果已超时过期1 |
| -404011 | SDK 云函数错误：云函数调用失败：函数执行失败 |
| -404012 | SDK 云函数错误：云函数调用失败：超出最大轮询超时后尝试次数2 |
| -40400x | SDK 云函数错误：云函数调用失败             |
| -501002 | 云资源通用错误：云端响应超时               |
| -501003 | 云资源通用错误：请求次数超出环境配额       |
| -501004 | 云资源通用错误：请求并发数超出环境配额     |
| -501005 | 云资源通用错误：环境信息异常               |
| -501007 | 云资源通用错误：参数错误                |
| -501009 | 云资源通用错误：操作的资源对象非法或不存在 |
| -501015 | 云资源通用错误：读请求次数配额耗尽          |
| -501016 | 云资源通用错误：写请求次数配额耗尽          |
| -501017 | 云资源通用错误：磁盘耗尽                    |
| -501018 | 云资源通用错误：资源不可用                  |
| -501019 | 云资源通用错误：未授权操作                  |
| -501020 | 云资源通用错误：未知参数错误                |
| -501021 | 云资源通用错误：操作不支持                  |
| -501023 | 云资源通用错误：无权限，比如：单页模式没有打开开关的情况下请求 API、安全规则校验失败 |
| -502001 | 云资源数据库错误：数据库请求失败             |
| -502002 | 云资源数据库错误：非法的数据库指令           |
| -502003 | 云资源数据库错误：无权限操作数据库           |
| -502005 | 云资源数据库错误：集合不存在                 |
| -502010 | 云资源数据库错误：操作失败                  |
| -502011 | 云资源数据库错误：操作超时                  |
| -502012 | 云资源数据库错误：插入失败                  |
| -502013 | 云资源数据库错误：创建集合失败              |
| -502014 | 云资源数据库错误：删除数据失败              |
| -502015 | 云资源数据库错误：查询数据失败              |
| -503001 | 云资源文件存储错误：云文件请求失败             |
| -503002 | 云资源文件存储错误：无权限访问云文件           |
| -503003 | 云资源文件存储错误：文件不存在                 |
| -504001 | 云资源云函数错误：云函数调用失败             |
| -504002 | 云资源云函数错误：云函数执行失败             |
| -601001 | 微信后台通用错误：系统错误             |
| -601002 | 微信后台通用错误：系统参数错误             |
| -601003 | 微信后台通用错误：系统网络错误             |
| -601004 | 微信后台通用错误：API 无权限             |
| -601005 | 微信后台通用错误：非法 cloudID             |
| -601006 | 微信后台通用错误：cloudID 已过期             |
| -601007 | 微信后台通用错误：cloudID 和当前用户不匹配             |
| -601008 | 微信后台通用错误：服务端内部请求超时             |
| -601009 | 微信后台通用错误：账号缺少手机号             |
| -601010 | 微信后台通用错误：缺少写权限             |
| -601011 | 微信后台通用错误：无权限             |
| -601012 | 微信后台通用错误：无权限访问该环境             |
| -601013 | 微信后台通用错误：没有多端/跨账号权限             |
| -601015 | 微信后台通用错误：拒绝访问（cloudbase_auth 函数返回空 errCode）             |
| -601016 | 微信后台通用错误：拒绝访问（无环境 auth 信息）             |
| -601017 | 微信后台通用错误：拒绝访问（cloudbase_auth 函数返回非 0 errCode）             |
| -601018 | 微信后台通用错误：未授权的 API             |
| -601022 | 微信后台通用错误：调用资源方云函数 cloudbase_auth 失败 |
| -601023 | 微信后台通用错误：资源方云函数 cloudbase_auth 返回无效回包 |
| -601027 | 微信后台通用错误：环境不存在 |
| -601034 | 微信后台通用错误：没有开通云服务 |
| -604001 | 微信后台云函数错误：回包大小超过 1M         |
| -604100 | 微信后台云函数错误：API 不存在         |
| -604101 | 微信后台云函数错误：无权限调用此 API，需要给云函数配置此 API 的云调用权限         |
| -604102 | 微信后台云函数错误：调用超时        |
| -604103 | 微信后台云函数错误：云调用系统错误        |
| -604104 | 微信后台云函数错误：非法调用来源        |
| -605101 | 微信后台 HTTP API 错误：查询语句解析失败         |
| -606001 | 微信后台云托管错误：请求包大小超过 100KB |
| -606002 | 微信后台云托管错误：响应包大小超过 1MB |
| -606003 | 微信后台云托管错误：账号欠费 |
| -606006 | 微信后台云托管错误：不允许未登录模式请求 |
| 102002 | 微信后台云托管错误：调用超时 |
| 102005 | 微信后台云托管错误：无效的 HTTP Method |

额外说明

1. 常见原因：发起调用后客户端网络异常；发起调用后在函数调用结果返回前切出小程序后台，并在后台函数调用结果缓存超期后才返回小程序前台。
2. 常见原因：客户端网络异常。

特殊错误说明：

* 如果 AppID 没有开通云开发服务，或刚开通云开发但还没有过准备期（十分钟），则调用 `cloud.init` 时会出现 `cloud init error：{ errMsg: "invalid scope" }` 的错误，如果是因没有开通云开发，则请先进行开通操作，如果是刚开通，请稍等十分钟再重试。