wvp - Android WebView 调试工具

一个基于 adb + WebSocket 代理的 Android WebView 调试 CLI，用于调试 uni-app App、自定义基座等开启了 WebView 调试的应用。

背景

Android WebView 的 devtools server 会拒绝带 Origin 头的 WebSocket 连接（返回 403），而 Chrome DevTools 前端连 ws 时必然带 Origin 头，导致 HBuilderX 的 inspect、chrome://inspect 等方案全部失败。

wvp 通过一个「去 Origin 代理」绕过此限制：

• 接收 Chrome DevTools 的连接（去掉 Origin）
• 用 Node 原生 WebSocket（不带 Origin）转发给手机 WebView

安装

npm install -g <你的 git 仓库地址>

使用

# 启动调试（交互式：选应用 → 列页面 → 复制链接）
wvp start

# 只列出可调试应用
wvp list

# 单独启动代理
wvp proxy

完整调试流程

1. 手机连接电脑，目标 app 已运行且开启了 WebView 调试
2. wvp start
3. 选择要调试的应用
4. 输入数字复制对应页面的调试链接
5. 打开 Chrome，地址栏粘贴回车
6. 切换路由后，按 r 重新探测

前置条件

• 已安装 Android SDK（adb 可用）
• 目标应用已调用 WebView.setWebContentsDebuggingEnabled(true)（uni-app 自定义基座默认开启）
• Chrome 浏览器

原理

Chrome DevTools 前端 (devtools://)
    │  ws://127.0.0.1:9333 (带 Origin)
    ▼
wvp 代理 (去掉 Origin)
    │  ws://127.0.0.1:8003 (不带 Origin)
    ▼
adb forward tcp:8003 → webview_devtools_remote_<pid>
    │
    ▼
手机 WebView

License

MIT