React / Vue 前后端分离项目实现微信分享教程

网上非常多的微信分享例子和教程,但是都不全面,甚至不少错误。自己根据微信官方文档踩了好几个坑才撸成功。痛定思痛,写下这篇文章,详细的告诉您 React / Vue 前后端分离项目的如何实现微信分享。


一. 申请微信订阅号/服务号

这个是必要条件。需要注意的是个人的微信订阅号是没有微信分享权限的。

二. 配置 JS 接口安全域名

登录微信公众平台,配置安全域名

安全域名

假设你的前端项目访问的主域名是 abc.com,那就填 abc.com。

三.后端获取微信签名

这个步骤需要后端服务器和微信服务器进行交互,获得「网页授权access_token」,根据 access_token 把关键的几个参数算出来,传给前端。这几个参数分别是:
appId , timestamp , nonceStr , signature
(因为本文主要针对前端开发者,后端的内容就不展开了)

后端要算出这几个参数不仅仅需要 access_token,还需要一个 URL 参数。这个 URL 是前端带有分享功能页面的当前 URL。
比如 www.abc.com/123 这个页面需要微信分享功能,那么就把这个 URL 传给后端,后端算出来参数后再返回给前端。

注意,只要 URL 发生变化,都得需要重新获取微信分享参数。除非个别页面不需要微信分享功能。

URL 配置

如果前端用的是react-router 或者 vue-router ,请尽量用 history 模式。如果你用的是 hash 模式,那么你给后端传递 URL 是有坑的,具体可以看这篇文章

四. 前端编写分享代码

打开微信分享官方文档
步骤大概是这样的

  1. 引入微信 JS sdk
  2. 通过config接口注入权限验证配置
  3. 步骤三:通过config接口注入权限验证配置
  4. 微信分享接口调用

第一步我们可以直接使用 weixin-js-sdk 这个库

npm install weixin-js-sdk --save

下面是前端代码:

import wx from 'weixin-js-sdk'

const ua = window.navigator.userAgent.toLowerCase()
// 如果不在微信浏览器内,微信分享也没意义了对吧?这里判断一下
if (ua.indexOf('micromessenger') < 0) return false

// 最好在在 router 的全局钩子里调用这个方法,每次页面的 URL 发生变化时,都需要重新获取微信分享参数
// 如果你的 router 使用的是 hash 形式,应该不用每次都重新获取微信分享参数
const data = $ajax.post({
  url: '当前页面的 URL',
  // xxx
  // xxx
})

wx.config({
  debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
  appId: '', // 必填,公众号的唯一标识
  timestamp: , // 必填,生成签名的时间戳
  nonceStr: '', // 必填,生成签名的随机串
  signature: '',// 必填,签名,见附录1
  jsApiList: [
    'onMenuShareAppMessage',
    'onMenuShareTimeline'
  ] // 必填,需要使用的JS接口列表,所有JS接口列表见附录2
})


wx.ready(() => {
  //分享给朋友
  wx.onMenuShareAppMessage({
    title: '', // 分享标题
    desc: '', // 分享描述
    link: '', // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致
    imgUrl: '', // 分享图标
    type: '', // 分享类型,music、video或link,不填默认为link
    dataUrl: '', // 如果type是music或video,则要提供数据链接,默认为空
    success: function () {
      // 用户确认分享后执行的回调函数
    },
    cancel: function () {
      // 用户取消分享后执行的回调函数
    }
  })

  //分享到朋友圈
  wx.onMenuShareTimeline({
    title: '', // 分享标题
    link: '', // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致
    imgUrl: '', // 分享图标
    success: function () {
      // 用户确认分享后执行的回调函数
    },
    cancel: function () {
      // 用户取消分享后执行的回调函数
    }
  })
})

代码亲测是没问题的,你可以下载一个微信开发者工具,打开对应的网页,测试没问题之后再用手机测试微信分享。


五. 关于 link 的坑

JSSDK自定义分享接口的策略调整

image.png

注意!!一定要按照规定填写 link 字段,不然微信开发者工具里测试成功,但是用手机测试还是会失败!!!

link // 分享链接,该链接域名或路径必须与当前页面对应的公众号JS安全域名一致

六.路由选择 history 模式还是 hash模式?

history 优点
  • URL 好看,没有 #
history 缺点
  • 如果你每一个页面都需要微信分享,那么每一个子路由都需要用当前的 URL 换取微信分享 config
  • 需要额外配置 nginx
hash 优点
  • 无需配置 nginx
  • 只需要用域名请求一次微信分享 config ,全部的子页面都能微信分享
hash 缺点
  • URL 里面有个 # ,不好看。但是如果你的网站是移动端的话就无所谓了。URL 不明显。

hash 的坑:拿 URL 换取微信分享 config 时,最好这么写:

const url = window.location.href.split('#')[0]

或者直接写主域名。例如http://wwww.baidu.com/
最后一定要加斜杠,别问我为什么。。。


10-24 更新:
开发的时候,一定要下载一个微信开发者工具,在那里面进行微信分享测试。代码开启 debug 模式后,如果签名错误,微信开发者工具会直接提醒你的。判断签名是否正确非常重要。


如果该文章对您有帮助,点赞支持下~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 160,026评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,655评论 1 296
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,726评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,204评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,558评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,731评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,944评论 2 314
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,698评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,438评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,633评论 2 247
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,125评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,444评论 3 255
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,137评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,103评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,888评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,772评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,669评论 2 271

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,103评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,574评论 25 707
  • 人类对宗教的热情创造出了无与伦比的美和伟大。在米兰,这座洁白高大而又精美繁复的建筑一共修建了六百多年,直到本世纪六...
    Lady_Ming阅读 378评论 1 1
  • 一段真实的故事,启发了小刚的思想,决定写这段文字给大学毕业正在择业和做职业规划的小朋友们…… 新时代的到来,互联网...
    罗宾猫先生阅读 1,042评论 0 0