不能在 uni-app 前端直接生成带参微信小程序码,必须由服务端调用 getwxacodeunlimit 接口;因微信强制要求 access_token 由后端统一缓存刷新、域名需 HTTPS 白名单、scene 长度≤32 字节且须 URL 编码,前端直调必失败。

不能在 uni-app 前端直接生成带参微信小程序码,必须走服务端调用 getwxacodeunlimit 接口——这不是限制,是微信的强制安全策略。
为什么 uni.request 调 getwxacodeunlimit 一定失败
前端暴露 appid 和 secret 是高危行为,微信服务器会直接拒绝请求;即使你本地 mock 成功,线上环境必然返回 {"errcode":40001,"errmsg":"invalid credential"} 或空白图。错误不是代码写错了,而是平台根本不允许这个调用路径。
-
access_token必须由服务端统一缓存、刷新(有效期仅 2 小时),前端无法安全持有 - 请求域名必须在微信后台配置 HTTPS 白名单,
uni.request在小程序中会因域名未备案直接拦截 - 微信接口返回的是二进制 PNG 流,前端没权限处理原始流,也无权拼接
access_token
服务端怎么正确调 getwxacodeunlimit
你的后端需要暴露一个简单 POST 接口(如 /api/qrcode/unlimited),接收参数并转发给微信,关键点不在“能发”,而在“稳住 token”和“压对 scene”。
Windows 微信自动发送工具。支持搜索微信联系人并发送文字、图片、文件和**批量文件**。通过 GUI 自动化控制微信窗口,无需微信开放接口。触发场景: 离开电脑时,远程指令OpenClaw发送图片/文件给微信联系人。条件: 微信打开并登录(允许最小化)。举例:1、把桌面上的龙虾图片发送给张三(默认微信发送);2、查找D盘最新的报价单Excel表并发送给李四(默认微信发送);3、搜索报价单并批量发送给联系人。
-
scene必须是纯 ASCII 字符串,长度 ≤32 字节;传uid=123&token=abc会失败,得先encodeURIComponent("uid=123&token=abc")再截断 -
page必须是小程序已配置的页面路径(如"pages/detail/detail"),路径不存在会返回errcode:41001 - 响应体建议转成
data:image/png;base64,...格式,避免额外托管和跨域;别手动拼前缀,<image :src=""></image>原生支持 - 务必用 Redis 缓存
access_token,否则每请求都重拉,很快触发微信频率限制(errcode:45009)
uni-app 扫码后怎么拿到 scene 参数
扫码跳转后,参数不在 options.query,而在 options.scene——这是最多人写错的地方。
- 如果扫的是小程序码(
getwxacodeunlimit生成的),参数通过字符串形式的options.scene传入,需手动decodeURIComponent -
onLoad(options)中直接解构const { scene } = options会得到undefined,因为options.scene是字符串,不是对象 - 正确做法:
const sceneData = JSON.parse(decodeURIComponent(options.scene))(若后端传的是 JSON 字符串),或按业务约定切分(如scene.split('_')) - 如果扫的是普通链接二维码(配置了「扫普通链接二维码打开小程序」),参数才在
options.query里
前端能自己生成的只有普通二维码
如果你只是要生成跳 H5 页面、展示文本或电子名片的二维码,不用碰微信接口,用 uqrcodejs 插件就行,它跨 H5/小程序/App 三端兼容。
- 安装命令必须是:
npm install uqrcodejs --save(包名不是uQRCode或qrcode) - 导入写法必须是:
import uQRCode from 'uqrcodejs'(ESM 导出,不支持require) - 中文内容务必提前
encodeURIComponent(),否则 H5 端扫码跳转会乱码 - 生成时机卡在
onReady或$nextTick,否则<canvas></canvas>元素未挂载,调用makeCode()会静默失败 - 尺寸别只设
width:推荐width: 280, size: 6, margin: 4, errorCorrectLevel: 'H',否则部分扫码器(尤其是微信内置)识别失败
真正的小程序带参码,永远是服务端的事;前端唯一要做的,就是把后端返回的 base64 正确渲染出来,并在扫码跳转后从 options.scene 里老老实实解析字符串——这两步漏掉任意一个,整个链路就断了。


















