---
url: https://open-wxa.github.io/wxa-runner/devtools-login.md
description: >-
  用 --devtools-login 借本机微信开发者工具的登录态访问微信后台：真实的 wx.login code 和手机号、服务市场
  wx.serviceMarket、插件页面，以及新版开发者工具需要打开的安全设置。
---

# 借用开发者工具登录态

有些能力要以开发者的身份访问微信后台，浏览器里做不到。启动时加上 `--devtools-login`，wxa-runner 借本机微信开发者工具的登录态（开发者 ticket）代为请求，
和开发者工具里一样拿到真实结果：

* `wx.login` 的 code 和手机号：不加时也会成功，但 code 是假的，真实后端不认（见 setup 的[默认返回](./setup.md#mock)）
* [服务市场](#服务市场) `wx.serviceMarket`：不加时调用失败
* [插件](#插件)页面：不加时不下载插件代码，打不开插件页面

```bash
wxa-runner dev ./dist/dev/mp-weixin --devtools-login
```

这个选项以前叫 `--real-login`（Playwright 的 `wxaServerOptions` 里是 `realLogin`），旧名暂时仍可用，启动时提示改用新名。

## 开启前的准备

* 当前登录的微信账号必须是 `project.config.json` 里这个 appid 的开发者
* 新版开发者工具（Electron 版，如 2.02.2609231）不再把登录态明文保存在磁盘上，要向正在运行的开发者工具要：
  启动时 wxa-runner 用开发者工具的命令行为项目开启自动化接口，开发者工具没在运行时会启动它，
  项目窗口没开时会打开。需要先在开发者工具「设置 → 安全设置」里打开：
  * **服务端口**
  * **允许获取工具登录票据**
  * 建议也打开「自动化接口打开工具时默认信任项目」，否则开发者工具会弹窗询问是否信任项目，点信任后才能继续
  * 设置了「CLI 访问令牌」时，把它设成环境变量 `WECHAT_DEVTOOLS_CLI_TOKEN`
* 旧版开发者工具照旧读磁盘上保存的登录态，不需要上面的设置
* 登录态过期时，在开发者工具里重新登录即可，不用重启。也可以用环境变量 `WECHAT_DEV_TICKET` 直接指定 ticket
* 请求失败时调用返回失败并说明原因，不会退回模拟数据
* 开发者 ticket 很快过期，不适合 CI。CI 里请用 setup 的 [`mock`](./setup.md#mock) 和 [`network.routes`](./setup.md#network)

## 服务市场

`wx.serviceMarket.invokeService` 也要借开发者工具的登录态。加了 `--devtools-login` 时，请求经开发服务器发给微信服务市场，
和开发者工具里一样拿到真实结果；没加时调用直接失败，提示加 `--devtools-login`。

* 项目的 appid 要已经在服务市场开通了这项服务，否则微信返回服务市场的错误码（如 `9301010 consumption failure`），
  `invokeService` 照常失败，错误里带着 requestId
* 只转发服务市场的请求，基础库发出的其他 `operateWXData` 不会带上开发者的登录态发给微信
* 需要 3.7.1 及以上的基础库（用 `--baselib` 指定）。3.7.0 及以前的基础库在浏览器里加载不了 `wx.serviceMarket` 所在的 SDK，
  调用时报 `Fatal: unexpected loadSdkSubPackage case`

## 插件

插件的代码不在项目里，和开发者工具一样要用开发者的登录态向微信下载。加了 `--devtools-login` 时，开发服务器下载 `app.json` 里声明的插件，
`wx.navigateTo`、`navigator` 组件打开的 `plugin://别名/页面` 和真机一样显示插件页面，插件里的网络请求照常发出。

* 项目的 appid 要已经在小程序管理后台「设置 → 第三方设置 → 插件管理」里添加了插件，并经插件开发者通过，否则终端提示微信返回的原因
* 没加 `--devtools-login` 时不下载插件，终端提示加上它；跳转插件页面时报 `page "…" is not found`，小程序自己的页面照常可用
* 插件代码只放在内存里，同一个插件版本只下载一次，重启开发服务器后重新下载
* 暂不支持插件的自定义组件（`usingComponents` 里的 `plugin://`）和业务代码里的 `requirePlugin`；分包里声明的插件也还没有下载（[#56](https://github.com/open-wxa/wxa-runner/issues/56)）
* 测试 API 的 `navigateTo` 等路由方法不认 `plugin://` 地址，要从页面里点击或调用 `wx.navigateTo` 打开插件页面