KnowFlow微信"发送给朋友 / 分享到朋友圈"可行性调研：绑定微信 + 文章详情分享方案
一句话概述：调研了在 KnowFlow 中实现"个人设置绑定微信 + 文章详情页发送给朋友/分享到朋友圈"的可行性，结论是两者均可行，但依赖已认证服务号与微信 JS-SDK，且分享动作无法代码直接触发，只能引导用户。
一、背景与目标
- 目标：为 KnowFlow 增加社交分享能力——用户在个人设置绑定微信，文章详情页提供"发送给朋友"和"分享到朋友圈"。
- 核心结论：两者都可行，但只能通过微信 JS-SDK 在微信内置浏览器中触发，无法在普通浏览器/独立 App 一键唤起。
二、微信 JS-SDK 分享机制
"发送给朋友"和"分享到朋友圈"是微信客户端的原生能力，通过微信 JS-SDK 的分享接口定制标题/描述/封面/链接，不是通过 API 后台推送。
| 能力 | 接口 | 说明 |
|---|---|---|
| 分享给朋友 | updateAppMessageShareData |
自定义标题/描述/链接/封面 |
| 分享到朋友圈 | updateTimelineShareData |
自定义标题/链接/封面 |
| 获取 JS-SDK 签名 | jsapi_ticket + 签名算法 |
后端生成签名，前端 wx.config() 初始化 |
实现流程
- 后端：用
access_token获取jsapi_ticket，按当前页面 URL 生成签名（noncestr+timestamp+url+ticket做 SHA1）。 - 前端：引入微信 JS-SDK（
jweixin-1.6.0.js），wx.config()注入签名，wx.ready()后调用分享接口。 - 触发：用户在微信内点右上角
···菜单，选择"发送给朋友"或"分享到朋友圈"时读取配置的分享文案。
关键限制
- 必须在微信内置浏览器中打开：普通浏览器或独立 App 无法触发，只能显示二维码引导用户用微信扫码。
- 分享动作无法用代码直接触发：微信禁止网页自动弹出分享面板，只能由用户主动点击。
- 需要已认证服务号：
jsapi_ticket需 AppID + AppSecret，且需配置 JS 接口安全域名。
三、"个人设置绑定微信"的实现方式
对应微信网页授权（OAuth2），用于把用户微信身份（openid/unionid）绑定到 KnowFlow 账号。
| 能力 | 说明 |
|---|---|
| 网页授权 | 跳转微信授权页，回调拿 code |
sns/oauth2/access_token |
用 code 换 access_token + openid |
sns/userinfo |
获取昵称、头像（需 snsapi_userinfo） |
两种授权 scope
| scope | 说明 | 适用 |
|---|---|---|
snsapi_base |
静默授权，无需确认，仅拿 openid |
仅标识用户身份 |
snsapi_userinfo |
需用户确认，可拿昵称/头像/openid/unionid | 展示用户微信信息 |
绑定流程
- 用户在个人设置页点击"绑定微信"。
- 跳转授权链接：
https://open.weixin.qq.com/connect/oauth2/authorize?appid=xxx&redirect_uri=xxx&response_type=code&scope=snsapi_userinfo#wechat_redirect。 - 用户确认授权，微信回调
redirect_uri带上code。 - 后端用
code换openid（+unionid），存到用户表完成绑定。
关键限制
- 网页授权仅认证服务号可用，个人订阅号无此权限。
- 必须在微信内打开授权链接，普通浏览器会提示"请在微信客户端打开"。
unionid用于跨公众号识别同一用户，单一公众号用openid即可。
四、整合方案
完整链路：个人设置绑定微信 → 文章详情页提供"发送给朋友"和"分享到朋友圈"按钮
| 步骤 | 实现 |
|---|---|
| 1. 绑定微信 | 个人设置页接入网页授权，存 openid |
| 2. 文章详情页 | 引入 JS-SDK，后端按文章 URL 生成签名 |
| 3. 分享配置 | updateAppMessageShareData（朋友）+ updateTimelineShareData（朋友圈），标题用文章标题、封面用头图 |
| 4. 非微信环境兜底 | 检测 UA，非微信内显示"请用微信扫码打开"二维码 |
重要现实约束
"发送给朋友"和"分享到朋友圈"无法通过代码直接弹起，只能：在微信内引导用户点右上角
···菜单，或页面内放"分享"按钮提示用户点击右上角。这是微信平台的硬性安全限制。
五、踩坑与修复（核心）
1. 误以为分享可以一键弹起
- 现象：想通过按钮直接唤起微信分享面板。
- 根因：微信出于安全考虑禁止网页自动弹出分享面板。
- 修复：改为引导用户点右上角菜单，分享文案已由 JS-SDK 配置好。
- 可复用经验：微信分享是"配置 + 引导"，不是"主动触发"。
2. 忽略"必须在微信内打开"的前提
- 现象：在普通浏览器测试分享无效果。
- 根因：JS-SDK 仅在微信内置浏览器生效。
- 修复：检测 UA，非微信环境显示二维码引导扫码打开。
- 可复用经验：分享功能必须考虑非微信环境的兜底引导。
3. 网页授权有主体资质门槛
- 现象：个人订阅号无法用网页授权绑定用户。
- 根因：网页授权（OAuth2）仅认证服务号可用。
- 修复：使用已认证服务号，配置 JS 接口安全域名。
- 可复用经验：接入前先确认公众号类型与认证状态。
六、结论
- 微信"发送给朋友"和"分享到朋友圈"均可行，依赖已认证服务号 + JS-SDK。
- 个人设置绑定微信通过网页授权（OAuth2）实现，存 openid/unionid。
- 分享动作无法代码直接触发，只能引导用户点右上角菜单。
- 落地需：认证服务号 + JS 接口安全域名 + 后端签名算法 + 前端 JS-SDK。
- 非微信环境需二维码引导兜底。