JS-SDK常见错误

随官方持续更新中

调用config 接口的时候传入参数 debug: true 可以开启debug模式,页面会alert出错误信息。以下为常见错误及解决方法:

  1. invalid url domain当前页面所在域名与使用的appid没有绑定(一个appid可以绑定三个有效域名,见 目录1.1.1)。
  2. invalid signature签名错误。建议按如下顺序检查:
    1. 确认签名算法正确,可用 http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=jsapisign 页面工具进行校验。
    2. 确认config中noncestr, timestamp与用以签名中的对应noncestr, timestamp一致。
    3. 确认url是页面完整的url,包括GET参数部分。
    4. 确认 config 中的 appid 与用来获取 jsapi_ticket 的 appid 一致。
    5. 确保一定缓存access_token和jsapi_ticket,可以减少两次服务器请求加速体验外,还避免了触发频率限制,提高服务稳定性。
  3. the permission value is offline verifying这个错误是因为config没有正确执行,或者是调用的JSAPI没有传入config的jsApiList参数中。建议按如下顺序检查:
    1. 确认config正确通过。
    2. 如果是在页面加载好时就调用了JSAPI,则必须写在wx.ready的回调中。
    3. 确认config的jsApiList参数包含了这个JSAPI。
  4. permission denied该公众号没有权限使用这个JSAPI(部分接口需要认证之后才能使用)。
  5. Android用户已取消分享朋友圈,但仍返回分享成功(微信团队已修复此问题,会在Android6.1版本上线)
  6. Android6.0.2部分客户端无法使用监听分享接口(Android6.0.2之前以及6.0.2.58以后的版本都不会有问题,请从官网下载最新版本体验)
  7. 服务上线之后无法获取jsapi_ticket,自己测试时没问题。因为access_token和jsapi_ticket必须要在自己的服务器缓存,否则上线后会触发频率限制。请确保一定对token和ticket做缓存以减少2次服务器请求,不仅可以避免触发频率限制,还加快你们自己的服务速度。目前为了方便测试提供了1w的获取量,超过阀值后,服务将不再可用,请确保在服务上线前一定缓存access_token和jsapi_ticket。
  8. Android部分版本上传图片接口偶尔卡住(早期的Android6.0.2版本存在此问题,官方已修复,6.0.2.58之后的版本都支持,请从官网下载最新版本体验)
  9. 下载多媒体相关jsapi只能下载通过jsapi上传的资源,无法下载通过多媒体后台接口上传的资源(微信团队已经确认该问题,正在努力修复中,预计本周修复上线)