当前位置：首页 > news >正文

微信小程序体验版指定页面测试二维码生成指南

news 2026/8/4 14:26:59

微信小程序体验版指定页面测试二维码生成指南

本文档详细介绍如何为微信小程序体验版生成指定页面的测试二维码，涵盖官方后台、开发者工具、API 接口三种方式，并附常见问题排查方案。

一、前置条件（必须先完成）

在生成指定页面的体验版二维码之前，请确保以下条件均已满足：

序号	条件	说明
1	已上传代码并提交体验版	微信公众平台 → 开发管理 → 开发版本 → 提交为体验版
2	已添加体验成员	未添加的微信号扫码无法打开体验版
3	已获取目标页面完整路径	格式：`pages/xxx/xxx?param=value`

页面路径示例

纯页面路径：pages/mine/mine
带参数页面：pages/detail/detail?id=666&type=goods
多级目录页面：pages/order/list/list?status=paid

⚠️ 路径必须与app.json中注册的页面路径完全一致，否则扫码后会跳首页或白屏。

二、方法一：微信公众平台后台生成（推荐）

这是官方最稳妥的方式，适合大多数场景。

操作步骤

登录微信公众平台
- 访问地址：https://mp.weixin.qq.com
- 使用小程序管理员账号扫码登录
进入开发版本管理
- 左侧菜单栏 → 【开发管理】→ 【开发版本】
获取体验二维码
- 找到已提交的体验版版本
- 点击右侧【获取体验二维码】按钮
修改页面路径
- 弹窗中默认显示首页路径
- 点击【修改页面路径】
- 粘贴目标页面的完整路径（含参数）
下载二维码
- 确认路径无误后，点击下载
- 保存的二维码即为体验版直达指定页面的测试码

注意事项

每次提交新的体验版后，旧二维码会失效，需要重新生成
只有添加为体验成员的微信账号可以扫码打开
普通用户扫码会提示"无法访问体验版"

三、方法二：微信开发者工具生成

适合开发阶段快速生成测试二维码。

操作步骤

打开微信开发者工具
- 导入你的小程序项目
进入生成小程序码功能
- 顶部菜单栏 → 【工具】→ 【生成小程序码】
配置参数
- 版本选择：选择「体验版」
- 页面路径：填入目标页面路径 + 参数
导出图片
- 点击确定，生成后导出为图片即可

四、方法三：API 接口批量生成

适合需要批量生成多个页面测试二维码的场景。

接口信息

接口名称：wxacode.getUnlimited
接口文档：微信开放文档 → 小程序 → 服务端 → 二维码

关键参数设置

{"scene":"page=detail&id=123","page":"pages/detail/detail","env_version":"trial","width":430,"auto_color":false,"line_color":{"r":0,"g":0,"b":0},"is_hyaline":false}

参数说明

参数	类型	必填	说明
`env_version`	string	否	要打开的小程序版本：`trial`（体验版）、`develop`（开发版）、`release`（正式版）
`page`	string	否	页面路径，必须是已发布的小程序存在的页面
`scene`	string	是	场景值，最大32个可见字符
`width`	number	否	二维码宽度，默认 430px

调用示例（Node.js）

constaxios=require('axios');constfs=require('fs');asyncfunctiongenerateTrialQrCode(pagePath,scene){// 1. 获取 access_tokenconsttokenRes=awaitaxios.get('https://api.weixin.qq.com/cgi-bin/token',{params:{grant_type:'client_credential',appid:'你的AppID',secret:'你的AppSecret'}});constaccessToken=tokenRes.data.access_token;// 2. 生成小程序码constqrRes=awaitaxios.post(`https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=${accessToken}`,{page:pagePath,scene:scene,env_version:'trial',width:430},{responseType:'arraybuffer'});// 3. 保存为图片fs.writeFileSync('./trial-qrcode.png',qrRes.data);console.log('二维码已生成');}// 使用示例generateTrialQrCode('pages/detail/detail','id=666');