2020-12-11

微信公众号跳转小程序所遇坑

根据微信开发者文档，满足以下条件就可以从网页公众号跳转指定小程序

微信版本要求为：7.0.12及以上。 系统版本要求为：iOS 10.3及以上、Android 5.0及以上

微信公众号跳转小程序文档

根据文档所说，跳转按钮格式为：

说明：

1. username是公众号的原始id，gh_开头的id，在微信公众平台可以找到
2. path是需要跳转的小程序页面路径，记得带上.html，需要带参数就直接在后面加，跟url一样，问号传参
3. 因为这里使用的是template，样式只能写在内部，否则无效~
4. vue报template错误的话在man.js加上 Vue.config.ignoredElements = ['wx-open-launch-weapp']

引入微信js

然后配置wx.config，一般文档都有写的很清楚，后台返回所需要的信息，前端配置下就可以了，大概如下：

this.$http.get('/api/wechat/jsapi-signature?url=' + url).then(response => {
        if (response.success) {
          wx.config({
            debug: false, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印
            appId: response.data.appId, // 必填，公众号的唯一标识
            timestamp: response.data.timestamp, // 必填，生成签名的时间戳
            nonceStr: response.data.nonceStr, // 必填，生成签名的随机串
            signature: response.data.signature, // 必填，签名
            jsApiList: ['wx-open-launch-weapp'], // 必填，需要使用的JS接口列表
            openTagList: ['wx-open-launch-weapp'] // 可选，需要使用的开放标签列表，例如['wx-open-launch-app']
          })
          that.getPredictList()
          // 通过ready接口处理成功验证
          wx.ready(function () {
            console.log('ready')
            // config信息验证后会执行ready方法，所有接口调用都必须在config接口获得结果之后，config是一个客户端的异步操作，所以如果需要在页面加载时就调用相关接口，则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口，则可以直接调用，不需要放在ready函数中
          })
          // 通过error接口处理失败验证
          wx.error(function (res) {
            console.log(res)
            // config信息验证失败会执行error函数，如签名过期导致验证失败，具体错误信息可以打开config的debug模式查看，也可以在返回的res参数中查看，对于SPA可以在这里更新签名
          })
        }
      })

这里说一个ios可能遇到的问题

很多时候，wx.config配置都正确，但是ios会出现进入页面的时候报invalid signature，签名是非法的，但是你刷新两次页面就会发现签名又成功了。会出现这个原因百分之九十是因为url的问题。具体分析参考一位网友的说明：

在IOS手机微信端，从A页面(http://a.com/A) 跳转到B页面(http://a.com/B)后，B页面进行分享时就会报签名（invalid signature）错误。
分析：
从A页面跳转到B页面时，由于是使用vue-router切换，都是操作浏览器历史记录，所以ios端微信浏览器锁定的url的还是A页面的url。

这个时候，是不是很多人都会认为，既然页面路由变化了，那我重新请求下url签名接口，不就可以了。呵呵呵，你会发现报错：invalid signature。但是再刷新一下，又没有签名问题，尼玛，这是什么原因呢？？？

那么你在请求url签名接口的时候，传递的url参数又是什么呢？大概如下吧：
url1、直接是 location.href （history模式）
url2、自己拼装的 location.origin + '/#' + this.$route.pullPath （hash模式）
这个时候，你请求的接口都没问题，也能拿到签名数据。但是

问题就出在：你所请求的url签名地址和浏览器执行jweixin-1.x.x.js时锁定的地址 不一致、不一致、不一致。你当前请求的可能是url1或url2，而此时微信锁定的地址仍然是进入A页面时的url（因为在进入A页面是加载并执行了jweixin-1.x.x.js, 而路由变化A到B时，并没有再次执行jxinwei-1.x.x.js）。所以问题就发生了，但是你再刷新一下，jweixin-1.x.x.js重新执行，此时微信浏览器锁定的url就是你当前刷新的url地址了，所以签名又成功了。
主要是因为：
【IOS】：ios微信端，路由变化时，微信认为SPA的url是不变的。
【Android】：android微信端，路由变化时，SPA的url是会变的（官方在安卓6.2版本，才对SPA变化作了支持）

所以，发起签名的url必须是微信锁定的url。

总的来说九十你发起的url跟微信签名的url不一样，解决方案就是进入页面的时候先锁定一个url，然后传递url的时候根据机器判断传哪一个。如下：

# router.js

router.beforeEach((to, from, next) => {
  if (/\/login\/*/.test(to.path)) {
    next()
  } else if (!sessionStorage.getItem('isLogin')) {
    next({ path: `/login?target=${to.path}` })
  } else {
    next()
  }

  if (typeof window.entryUrl === 'undefined' || window.entryUrl === '') {
    window.entryUrl = location.href.split('#')[0]
  }
})

# 对应page
 let url = ''
 let u = navigator.userAgent;
 let isIOS = !!u.match(/\(i[^;]+;( U;)? CPU.+Mac OS X/); //ios终端
 if (isIOS) {
 url=window.entryUrl
 }else{
 url = window.location.href;
 }
 ...
 # 调用wx.config的参数接口

我项目里完整的例子如下：

# page

``