必须由后端生成signature,因前端传的url与后端签名用的url常不一致:如含#后片段、未encode中文、jsapi_ticket过期、timestamp超时偏差或时钟不同步。

不能直接在 HTML 里配好参数就调用 wx.config,必须由后端生成签名(signature),前端只负责注入和调用。这是绝大多数人卡住的第一步。
为什么 wx.config 总是提示 invalid signature 或 config:fail
核心原因是签名计算不一致:前端传给后端的 url 和后端用来签名的 url 不完全相同。常见差异包括:
- 前端用
location.href拿到带#后 fragment 的完整 URL,但微信签名要求只取#前的部分(即location.href.split("#")[0]) - URL 中含中文、空格、特殊符号,前端未做
encodeURI,后端解码失败或拼接出错 - 后端生成签名时,
jsapi_ticket过期或拿错了类型(比如用了type=wx_card的 ticket 去签 JS 接口) - 时间戳(
timestamp)和服务端当前时间偏差超过 7200 秒,或前后端时钟不同步(尤其 Docker 容器未同步 NTP)
后端必须提供 /wx-sign 接口返回哪些字段
这个接口接收前端传来的当前页面 URL(已 encode),返回签名所需全部参数。返回体应包含:
-
appId:公众号的AppID,不是第三方平台 ID -
timestamp:整数时间戳(秒级,非毫秒),与前端保持一致 -
nonceStr:长度 16 位以上的随机字符串,建议用 UUIDv4 截取或 crypto.randomBytes -
signature:按微信文档规则拼接字符串并 SHA1 加密得到,顺序必须是:jsapi_ticket=xxx&noncestr=xxx×tamp=xxx&url=xxx -
jsApiList:数组,如["updateAppMessageShareData", "chooseImage"],不能有空格、大小写错误或未授权的接口名
注意:jsapi_ticket 必须通过 access_token 调用 https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=jsapi 获取,且需缓存 —— 官方限制每 2 小时最多调用 2000 次,硬刷会触发限流。
如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更
前端初始化 wx.config 的典型写法(含容错)
不要等 DOM ready 再发签名请求,也不要在 SPA 路由变化时无脑重 config。关键点:
- 确保
https://res.wx.qq.com/open/js/jweixin-1.6.0.js已加载完成再执行后续逻辑(可用window.wx判断,或加onload回调) -
wx.config必须在页面 URL 稳定后调用 —— 对于 Vue/React 路由,应在router.afterEach或useEffect(() => {}, [location.pathname])中触发,且每次只对新 URL 请求签名 - 务必监听
wx.error并打印原始错误,例如:wx.error(err => console.error("wx config error", err)),很多问题靠这个才能定位 - 调试阶段打开
debug: true,真机测试时关闭,否则安卓微信 8.0+ 会因调试弹窗阻塞后续调用
const url = encodeURIComponent(location.href.split("#")[0]);
fetch("/wx-sign?url=" + url)
.then(r => r.json())
.then(conf => {
wx.config({
appId: conf.appId,
timestamp: conf.timestamp,
nonceStr: conf.nonceStr,
signature: conf.signature,
jsApiList: conf.jsApiList,
debug: false
});
});
常见 JS 接口调用失败的隐藏原因
即使 wx.config 成功,具体接口仍可能报 invoke:fail permission denied 或 not in wechat:
- 当前页面域名未在公众号后台「JS接口安全域名」中备案(注意:只认一级域名,
www.a.com≠a.com,test.a.com需单独添加) - 用户未在微信内置浏览器打开,而是用 Safari / Chrome 打开链接(此时
window.wx为 undefined) - 调用
wx.chooseImage等需要用户主动触发的接口时,没包在button.onclick或input onchange里,而是放在setTimeout或异步回调中 —— iOS 微信会拒绝静默调用 - 分享类接口(如
updateAppMessageShareData)必须在wx.ready后设置,且不能晚于用户点击分享按钮前 5 秒,否则新版本微信会忽略
最易被忽略的是:所有签名依赖的原始数据(url、jsapi_ticket、nonceStr、timestamp)必须全程保持纯文本传输,任何中间层(Nginx、CDN、网关)做 URL decode / re-encode 都会导致签名失效 —— 这类问题往往查三天才发现是反向代理干的。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










