HTML怎么做微信JS-SDK_HTML微信JS-SDK接口调用方法【整理】

P粉328763957

P粉328763957

2026-04-28

871人浏览

原创

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

html怎么做微信js-sdk_html微信js-sdk接口调用方法【整理】

不能直接在 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&timestamp=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应用程序 英文文字pdf版附源文件
使用HTML,CSS,JavaScript开发Android应用程序 英文文字pdf版附源文件

如果你了解HTML,CSS和JavaScript,您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造,可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Andr​​oid友好的网络应用程序,然后转换与自由PhoneGap框架到一个原生的Andr​​oid应用程序。了解为什么设备无关的移动应用是未来的潮流,并开始构建应用程序,提供更

下载

前端初始化 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.afterEachuseEffect(() => {}, [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 deniednot in wechat

  • 当前页面域名未在公众号后台「JS接口安全域名」中备案(注意:只认一级域名,www.a.coma.comtest.a.com 需单独添加)
  • 用户未在微信内置浏览器打开,而是用 Safari / Chrome 打开链接(此时 window.wx 为 undefined)
  • 调用 wx.chooseImage 等需要用户主动触发的接口时,没包在 button.onclickinput onchange 里,而是放在 setTimeout 或异步回调中 —— iOS 微信会拒绝静默调用
  • 分享类接口(如 updateAppMessageShareData)必须在 wx.ready 后设置,且不能晚于用户点击分享按钮前 5 秒,否则新版本微信会忽略

最易被忽略的是:所有签名依赖的原始数据(urljsapi_ticketnonceStrtimestamp)必须全程保持纯文本传输,任何中间层(Nginx、CDN、网关)做 URL decode / re-encode 都会导致签名失效 —— 这类问题往往查三天才发现是反向代理干的。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关文章

HTML速学教程(入门课程)
HTML速学教程(入门课程)

HTML怎么学习?HTML怎么入门?HTML在哪学?HTML怎么学才快?不用担心,这里为大家提供了HTML速学教程(入门课程),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

html js 微信

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2574

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

1678

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

1417

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

1365

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

3687

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

1392

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

1151

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

1080

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

1011

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 入门安装配置
Bootstrap 入门安装配置

共0课时 | 0人学习

38+ PhpStorm 提示和技巧
38+ PhpStorm 提示和技巧

共1课时 | 156人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 5万人学习