错误码和 HError 对象

HError 错误对象的格式

在大部分情况下，SDK API 抛出的错误统一为 HError 类的实例，可以使用 try-catch 块进行捕捉，若 SDK 的 API 返回值是一个 Promise 时，HError 对象则会作为 catch 回调的参数。

HError 实例上有两个重要的属性，对调试错误很有帮助：

字段名类型说明
codeinteger错误码
messagestring错误描述

示例代码

  1. // SDK API 返回值是一个 Promise 对象，在 catch 中捕捉错误
  3. wx.BaaS.login().then(res => {
  4.   console.log('登录成功')
  5. }, err => {
  6.   // err 为 HError 类实例
  7.   if (err.code === 600) {
  8.     console.log('网络已断开')
  9.   } if (err.code === 601) {
  10.     console.log('请求超时')
  11.   }
  12.   // ...
  13. })
  1. // SDK API 返回值是一个 Promise 对象，在 catch 中捕捉错误
  3. qq.BaaS.login().then(res => {
  4.   console.log('登录成功')
  5. }, err => {
  6.   // err 为 HError 类实例
  7.   if (err.code === 600) {
  8.     console.log('网络已断开')
  9.   } if (err.code === 601) {
  10.     console.log('请求超时')
  11.   }
  12.   // ...
  13. })
  1. // SDK API 返回值是一个 Promise 对象，在 catch 中捕捉错误
  3. BaaS.login().then(res => {
  4.   console.log('登录成功')
  5. }, err => {
  6.   // err 为 HError 类实例
  7.   if (err.code === 600) {
  8.     console.log('网络已断开')
  9.   } if (err.code === 601) {
  10.     console.log('请求超时')
  11.   }
  12.   // ...
  13. })
  1. // SDK API 返回值是一个 Promise 对象，在 catch 中捕捉错误
  3. my.BaaS.login().then(res => {
  4.   console.log('登录成功')
  5. }, err => {
  6.   // err 为 HError 类实例
  7.   if (err.code === 600) {
  8.     console.log('网络已断开')
  9.   } if (err.code === 601) {
  10.     console.log('请求超时')
  11.   }
  12.   // ...
  13. })
  1. // SDK API 返回值是一个 Promise 对象，在 catch 中捕捉错误
  3. swan.BaaS.login().then(res => {
  4.   console.log('登录成功')
  5. }, err => {
  6.   // err 为 HError 类实例
  7.   if (err.code === 600) {
  8.     console.log('网络已断开')
  9.   } if (err.code === 601) {
  10.     console.log('请求超时')
  11.   }
  12.   // ...
  13. })
  1. // SDK API 是一个同步的操作，则用 try-catch 来捕捉错误
  3. let product = new wx.BaaS.TableObject(1234)
  5. // setQuery 方法必须传递一个 wx.BaaS.Query 对象
  6. try {
  7.   product.setQuery(123)
  8. } catch (err) {
  9.   console.log(err.code) // 605
  10. }
  1. // SDK API 是一个同步的操作，则用 try-catch 来捕捉错误
  3. let product = new qq.BaaS.TableObject(1234)
  5. // setQuery 方法必须传递一个 qq.BaaS.Query 对象
  6. try {
  7.   product.setQuery(123)
  8. } catch (err) {
  9.   console.log(err.code) // 605
  10. }
  1. // SDK API 是一个同步的操作，则用 try-catch 来捕捉错误
  3. let product = new BaaS.TableObject(1234)
  5. // setQuery 方法必须传递一个 BaaS.Query 对象
  6. try {
  7.   product.setQuery(123)
  8. } catch (err) {
  9.   console.log(err.code) // 605
  10. }
  1. // SDK API 是一个同步的操作，则用 try-catch 来捕捉错误
  3. let product = new my.BaaS.TableObject(1234)
  5. // setQuery 方法必须传递一个 my.BaaS.Query 对象
  6. try {
  7.   product.setQuery(123)
  8. } catch (err) {
  9.   console.log(err.code) // 605
  10. }
  1. // SDK API 是一个同步的操作，则用 try-catch 来捕捉错误
  3. let product = new swan.BaaS.TableObject(1234)
  5. // setQuery 方法必须传递一个 swan.BaaS.Query 对象
  6. try {
  7.   product.setQuery(123)
  8. } catch (err) {
  9.   console.log(err.code) // 605
  10. }

错误码详解

错误码对应的错误信息如下：

400 Bad Request 参数错误

401 Unauthorized 未授权

402 Payment Required 应用欠费

403 Forbidden 禁止访问

404 Not Found 服务器找不到给定的资源

500 Internal Server Error 内部服务器错误

600 network disconnected 网络已断开

601 request timeout 请求超时

602 uninitialized 未调用 BaaS.init() 进行初始化

603 unauthorized 用户尚未授权

604 session missing 用户尚未登录

605 incorrect parameter type 不正确的参数类型

607 payment cancelled 用户取消支付

608 payment failed 支付失败

609 wxExtend function should be executed to allow plugin use wx.login, wx.getUserInfo, wx.requestPayment 使用小程序插件版本的 sdk，需先调用 wx.BaaS.wxExtend 方法完成初始化配置

610 errorTracker uninitialized errorTracker 未初始化

611 unsupported function 不支持该方法

612 anonymous user is not allowed 临时匿名用户不支持调用该方法

613 third party auth denied 用户拒绝第三方授权

614 third party auth failed 第三方授权失败

615 gateway type "weixin_tenpay_js" works in WeChat builtin browser only 支付类型 "weixin_tenpay_js" 只能在微信内置浏览器用使用