just do it

微信开发注意事项 分享到朋友圈、发送给朋友

2017 年 03 月 21 日 0条评论 9,173次阅读 1人点赞

最近开发微信活动的时候，发现分享到朋友圈和发送给朋友功能不稳定，时而有效时而无效，打开debug模式查看，发现多数报的数签名错误，仔细看了官方文档，最终问题出在ticket的缓存上。

1、签名：

url： 需要根据不同的页面动态获取，url不能进行encodeURIComponent，否则验签会失败 url不能包括微信添加的#后边的部分，所以应该处理为：window.location.href.split(‘#’)[0] 签名用的url必须是调用JS接口页面的完整URL。
nonceStr、timestamp：应该动态生成，而不能hardcode 签名用的noncestr和timestamp必须与wx.config中的nonceStr和timestamp相同
为安全考虑，签名必须在后台进行，其他调用js在前台进行。
2、ticket和accesstoken：

accesstoken：同调用微信其他接口的accesstoken，必须全局缓存，以免影响其他业务，即是说：微信所有业务应该用同一个accesstoken去调用微信接口，而不能自己刷新accesstoken。
ticket：同accesstoken一样，必须全局缓存，方式很多，可以放到数据库，或者放到缓存。目前ticket的有效时间为2小时，所以2小时内ticket未过期时，不能重复获取，否则可能导致ticket获取次数超过限额，导致sign失败。
3、注意代码执行顺序

首先应该获取签名，签名获取后在调用wx.config方法，然后再执行wx.ready、wx.error方法。

4、其他

每个页面加载完成后都应该重新从后台获取签名信息，避免签名失败

具体开发步骤详见官方文档

5、官方常见问题及处理方法：

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

1、invalid url domain

当前页面所在域名与使用的appid没有绑定，请确认正确填写绑定的域名，如果使用了端口号，则配置的绑定域名也要加上端口号（一个appid可以绑定三个有效域名，见 目录1.1.1）。

2、invalid signature签名错误。

建议按如下顺序检查：

确认签名算法正确，可用 http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=jsapisign 页面工具进行校验。

确认config中nonceStr（js中驼峰标准大写S）, timestamp与用以签名中的对应noncestr, timestamp一致。

确认url是页面完整的url(请在当前页面alert(location.href.split(‘#’)[0])确认)，包括’http(s)://’部分，以及’？’后面的GET参数部分,但不包括’#’hash后面的部分。

确认 config 中的 appid 与用来获取 jsapi_ticket 的 appid 一致。

确保一定缓存access_token和jsapi_ticket。

确保你获取用来签名的url是动态获取的，动态页面可参见实例代码中php的实现方式。 如果是html的静态页面在前端通过ajax将url传到后台签名，前端需要用js获取当前页面除去’#’hash部分的链接（可用location.href.split(‘#’)[0]获取,而且需要encodeURIComponent），因为页面一旦分享，微信客户端会在你的链接末尾加入其它参数，如果不是动态获取当前链接，将导致分享后的页面签名失败。

3、the permission value is offline verifying

这个错误是因为config没有正确执行，或者是调用的JSAPI没有传入config的jsApiList参数中。建议按如下顺序检查：

确认config正确通过。
如果是在页面加载好时就调用了JSAPI，则必须写在wx.ready的回调中。
确认config的jsApiList参数包含了这个JSAPI。
4、permission denied

该公众号没有权限使用这个JSAPI，或者是调用的JSAPI没有传入config的jsApiList参数中（部分接口需要认证之后才能使用）。

5、function not exist

当前客户端版本不支持该接口，请升级到新版体验。

6、为什么6.0.1版本config:ok，但是6.0.2版本之后不ok

因为6.0.2版本之前没有做权限验证，所以config都是ok，但这并不意味着你config中的签名是OK的，请在6.0.2检验是否生成正确的签名以保证config在高版本中也ok。

7、在iOS和Android都无法分享

请确认公众号已经认证，只有认证的公众号才具有分享相关接口权限，如果确实已经认证，则要检查监听接口是否在wx.ready回调函数中触发

8、服务上线之后无法获取jsapi_ticket，自己测试时没问题。

因为access_token和jsapi_ticket必须要在自己的服务器缓存，否则上线后会触发频率限制。请确保一定对token和ticket做缓存以减少2次服务器请求，不仅可以避免触发频率限制，还加快你们自己的服务速度。目前为了方便测试提供了1w的获取量，超过阀值后，服务将不再可用，请确保在服务上线前一定全局缓存access_token和jsapi_ticket，两者有效期均为7200秒，否则一旦上线触发频率限制，服务将不再可用。

9、uploadImage怎么传多图

目前只支持一次上传一张，多张图片需等前一张图片上传之后再调用该接口

10、没法对本地选择的图片进行预览

chooseImage接口本身就支持预览，不需要额外支持

11、通过a链接(例如先通过微信授权登录)跳转到b链接，invalid signature签名失败

后台生成签名的链接为使用jssdk的当前链接，也就是跳转后的b链接，请不要用微信登录的授权链接进行签名计算，后台签名的url一定是使用jssdk的当前页面的完整url除去’#’部分

12、出现config:fail错误

这是由于传入的config参数不全导致，请确保传入正确的appId、timestamp、nonceStr、signature和需要使用的jsApiList

13、如何把jsapi上传到微信的多媒体资源下载到自己的服务器

请参见文档中uploadVoice和uploadImage接口的备注说明

14、Android通过jssdk上传到微信服务器，第三方再从微信下载到自己的服务器，会出现杂音

微信团队已经修复此问题，目前后台已优化上线

15、绑定父级域名，是否其子域名也是可用的

是的，合法的子域名在绑定父域名之后是完全支持的

16、在iOS微信6.1版本中，分享的图片外链不显示，只能显示公众号页面内链的图片或者微信服务器的图片，已在6.2中修复

17、是否需要对低版本自己做兼容

jssdk都是兼容低版本的，不需要第三方自己额外做更多工作，但有的接口是6.0.2新引入的，只有新版才可调用

18、该公众号支付签名无效，无法发起该笔交易

请确保你使用的jweixin.js是官方线上版本，不仅可以减少用户流量，还有可能对某些bug进行修复，拷贝到第三方服务器中使用，官方将不对其出现的任何问题提供保障，具体支付签名算法可参考 JSSDK微信支付一栏

19、目前Android微信客户端不支持pushState的H5新特性，所以使用pushState来实现web app的页面会导致签名失败，此问题已在Android6.2中修复

20、uploadImage在chooseImage的回调中有时候Android会不执行

Android6.2会解决此问题，若需支持低版本可以把调用uploadImage放在setTimeout中延迟100ms解决

21、require subscribe错误说明你没有订阅该测试号，该错误仅测试号会出现

22、getLocation返回的坐标在openLocation有偏差

因为getLocation返回的是gps坐标，openLocation打开的腾讯地图为火星坐标，需要第三方自己做转换，6.2版本开始已经支持直接获取火星坐标

23、查看公众号（未添加）: “menuItem:addContact”不显示

目前仅有从公众号传播出去的链接才能显示，来源必须是公众号

24、ICP备案数据同步有一天延迟，所以请在第二日绑定

6、示例：

1、jssdk封装

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

<?php
class JSSDK {
  private $appId;
  private $appSecret;
 
  public function __construct($appId, $appSecret) {
    $this->appId = $appId;
    $this->appSecret = $appSecret;
  }
 
  public function getSignPackage() {
    $jsapiTicket = $this->getJsApiTicket();
    $url = "http://$_SERVER[HTTP_HOST]$_SERVER[REQUEST_URI]";
    $timestamp = time();
    $nonceStr = $this->createNonceStr();
 
    // 这里参数的顺序要按照 key 值 ASCII 码升序排序
    $string = "jsapi_ticket=$jsapiTicket&noncestr=$nonceStr&timestamp=$timestamp&url=$url";
 
    $signature = sha1($string);
 
    $signPackage = array(
      "appId"     => $this->appId,
      "nonceStr"  => $nonceStr,
      "timestamp" => $timestamp,
      "url"       => $url,
      "signature" => $signature,
      "rawString" => $string
    );
    return $signPackage; 
  }
 
  private function createNonceStr($length = 16) {
    $chars = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
    $str = "";
    for ($i = 0; $i < $length; $i++) {
      $str .= substr($chars, mt_rand(0, strlen($chars) - 1), 1);
    }
    return $str;
  }
 
  private function getJsApiTicket() {
    // jsapi_ticket 应该全局存储与更新，以下代码以写入到文件中做示例
    $data = json_decode(file_get_contents("jsapi_ticket.json"));
    if ($data->expire_time < time()) {
      $accessToken = $this->getAccessToken();
      $url = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?type=jsapi&access_token=$accessToken";
      $res = json_decode($this->httpGet($url));
      $ticket = $res->ticket;
      if ($ticket) {
        $data->expire_time = time() + 7000;
        $data->jsapi_ticket = $ticket;
        $fp = fopen("jsapi_ticket.json", "w");
        fwrite($fp, json_encode($data));
        fclose($fp);
      }
    } else {
      $ticket = $data->jsapi_ticket;
    }
 
    return $ticket;
  }
 
  private function getAccessToken() {
    // access_token 应该全局存储与更新，以下代码以写入到文件中做示例
    $data = json_decode(file_get_contents("access_token.json"));
    if ($data->expire_time < time()) {
      $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$this->appId&secret=$this->appSecret";
      $res = json_decode($this->httpGet($url));
      $access_token = $res->access_token;
      if ($access_token) {
        $data->expire_time = time() + 7000;
        $data->access_token = $access_token;
        $fp = fopen("access_token.json", "w");
        fwrite($fp, json_encode($data));
        fclose($fp);
      }
    } else {
      $access_token = $data->access_token;
    }
    return $access_token;
  }
 
  private function httpGet($url) {
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_TIMEOUT, 500);
    curl_setopt($curl, CURLOPT_URL, $url);
 
    $res = curl_exec($curl);
    curl_close($curl);
 
    return $res;
  }
}

2.后台获取接口相关参数

1
2
3
4
5
6

  //获取微信配置参数 
    $appid = $wxch_config['appid'];
    $appsecret = $wxch_config['appsecret'];
    $jssdk = new JSSDK($appid,$appsecret);
    $signPackage = $jssdk->GetSignPackage();
    $smarty->assign('signPackage',$signPackage);

3.前台获取jssdk：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

<script>
  wx.config({
    appId: '{$signPackage.appId}',
    timestamp: {$signPackage.timestamp},
    nonceStr: '{$signPackage.nonceStr}',
    signature: '{$signPackage.signature}',
    jsApiList: ['onMenuShareAppMessage','onMenuShareTimeline']
  });
 
function _shareAppMessage(){
      wx.onMenuShareAppMessage({
      title: '{$page_title}',
      desc: '{$page_title}-{$order.goods_name} 描述文字',
      link: '{$site_url}mobile/order_group.php?act=order_detail&order_id={$order.order_id}',
      imgUrl: '{$site_url}{$order.goods_thumb}',
      trigger: function (res) {
 
 
      },
      success: function (res) {
          $(".pormpt").addClass("hidden");
         $("body").removeClass("ovebod");
         $("html").removeClass("ovebod");
      },
      cancel: function (res) {
 
      },
      fail: function (res) {
 
      }
    });
} 
function _shareTimeline() {
      wx.onMenuShareTimeline({
      title: '{$page_title}-{$order.goods_name} 链接标题',
 
      link: '{$site_url}mobile/order_group.php?act=order_detail&order_id={$order.order_id}',
      imgUrl: '{$site_url}{$order.goods_thumb}',
      trigger: function (res) {
 
 
      },
      success: function (res) {
          $(".pormpt").addClass("hidden");
         $("body").removeClass("ovebod");
         $("html").removeClass("ovebod");
      },
      cancel: function (res) {
 
      },
      fail: function (res) {
 
      }
    });
}
 
  wx.ready(function () {
   _shareAppMessage();
   _shareTimeline();
  });
 
</script>
点赞
No Tag
知识共享许可协议
本作品采用 知识共享署名-相同方式共享 4.0 国际许可协议 进行许可