借用开发者工具登录态
有些能力要以开发者身份访问微信后台,浏览器里做不到。启动时加上 --devtools-login,wxa-runner 借本机微信开发者工具的登录态(开发者 ticket)代为请求,拿到真实结果:
wx.login的 code 和手机号:不加时也会成功,但 code 是假的,真实后端不认(见 setup 的默认返回)- 服务市场
wx.serviceMarket:不加时调用失败 - 插件页面:不加时不下载插件代码,打不开插件页面
wxa-runner dev ./dist/dev/mp-weixin --devtools-login以前叫 --real-login(Playwright 的 wxaServerOptions 里是 realLogin),旧名已移除。
开启前的准备
- 开发者工具里登录的微信账号,要是
project.config.json里这个 appid 的开发者 - 新版开发者工具(Electron 版,如 2.02.2609231):在「设置 → 安全设置」里打开 服务端口 和 允许获取工具登录票据。 建议也打开「自动化接口打开工具时默认信任项目」,否则开发者工具会弹窗问是否信任项目,点信任后才能继续。 设置了「CLI 访问令牌」时,把它设成环境变量
WECHAT_DEVTOOLS_CLI_TOKEN。旧版开发者工具不需要这一步 - 安全设置里找不到「允许获取工具登录票据」时,见下面的取不到票据
为什么新版要这些设置
新版不再把登录态明文存在磁盘上,要向正在运行的开发者工具要:启动时 wxa-runner 用开发者工具的命令行为项目开启自动化接口, 开发者工具没在运行时会启动它,项目窗口没开时会打开。旧版照旧读磁盘上保存的登录态。
- 登录态过期时,在开发者工具里重新登录即可,不用重启。也可以用环境变量
WECHAT_DEV_TICKET直接指定 ticket - 请求失败时调用返回失败并说明原因,不会退回模拟数据
- 开发者 ticket 很快过期,不适合 CI。CI 里请用 setup 的
mock和network.routes
取不到票据
「允许获取工具登录票据」这个开关不是每个 appid 都有:开发者工具先问微信后台这个 appid 能不能取票据,不能就根本不显示这个开关, 本机怎么设置都改不出来。
这时 wx.login 仍然能拿到真实的 code:wxa-runner 改让开发者工具的模拟器自己调 wx.login,这条路不查那个名单。 终端会提示一次,调用方不用改。拿到的 code 和真机一样,能用 appsecret 换到 session_key。 唯一的例外是你在开发者工具里 mock 过 wx.login——那样拿到的是 mock 值。
手机号、服务市场和插件没有这条路,调用时会失败:
- 最直接的办法:换一个能取到票据的开发者工具版本。 取不到票据是某些版本的开发者工具(本文测试的是 Nightly
2.02.2611062) 新加的限制;换用能正常显示「允许获取工具登录票据」、能取到票据的版本(一般是正式版 Stable),手机号、服务市场、插件就都照常工作。 要用--devtools-login拿真实手机号,就别用会拦票据的这版工具。 下面几条是换不了版本时的退路: - 手机号、服务市场:去掉
--devtools-login,用 setup 的mock和network.routes造数据来测业务流程。拿不到真实手机号,但页面和接口的逻辑能跑通 - 插件页面:没有替代办法。插件代码要用开发者身份向微信下载,浏览器侧造数据补不出插件包, 没有可用票据时插件页面打不开
- 另有办法拿到票据时(比如在能取票据的机器上取好),可以用环境变量
WECHAT_DEV_TICKET传进来。 票据很快过期,适合临时验证,不适合长期用
为什么手机号不行
手机号的开关在微信后台,不在开发者工具这边。模拟器取手机号时,先向后台请求 jsgetuserwxphone:后台放不放手机号包, 在你点授权弹窗之前就已经定了。取不到票据的这个 appid,后台这一步直接返回失败(-10000 一类),于是弹的是报错框,根本不会弹授权框。
那个「允许」按钮不是一道能绕过去的关:按钮只有在后台已经把包给出来之后才出现,点它只是把已经拿到的包回传给小程序, 不发任何确认请求、不生成票据。所以没有哪一步是前端能替你点通的——后台不放包,就是没有。 (开发者工具里的「测试号」选项也能弹出手机号,但那是本地造的虚拟号,没有合法 session_key 能解密,不是真号。)
自动化协议里只有 Tool.getTicket 能取票据,它就是被上面那道检查拦住的那个; Tool.refreshTicket 只刷新不返回,Tool.setTicket 是反方向的注入。没有第二个出口——除非换一个能取到票据的开发者工具版本。
服务市场
wx.serviceMarket.invokeService 也要借开发者工具的登录态:加了 --devtools-login 时,请求经开发服务器发给微信服务市场,拿到真实结果;没加时直接失败,提示加上它。
- 项目的 appid 要在服务市场开通了这项服务,否则
invokeService失败,错误里带着微信返回的错误码(如9301010 consumption failure)和 requestId - 只转发服务市场的请求,基础库发出的其他
operateWXData不会带上开发者的登录态发给微信 - 需要 3.7.1 及以上的基础库(用
--baselib指定)。3.7.0 及以前的版本在浏览器里加载不了它所在的 SDK,调用时报Fatal: unexpected loadSdkSubPackage case
插件
插件代码不在项目里,要用开发者的登录态向微信下载。加了 --devtools-login 时,开发服务器下载 app.json 里声明的插件, 用 wx.navigateTo 或 navigator 打开的 plugin://别名/页面 和真机一样显示,插件里的网络请求照常发出。
- 项目的 appid 要在小程序管理后台「设置 → 第三方设置 → 插件管理」里添加了插件,并经插件开发者通过,否则终端提示微信返回的原因
- 没加
--devtools-login时不下载插件,终端提示加上它;跳转插件页面时报page "…" is not found,小程序自己的页面照常可用 - 插件代码只放在内存里,同一个插件版本只下载一次,重启开发服务器后重新下载
- 暂不支持插件的自定义组件(
usingComponents里的plugin://)和业务代码里的requirePlugin;分包里声明的插件也还没有下载(#56) - 测试 API 的
navigateTo等路由方法不认plugin://地址,要从页面里点击或调用wx.navigateTo打开插件页面

