直接答案
先确认数据线支持传输、手机 USB 用途是文件传输且 USB 调试已开启。如果设备仍不出现,撤销并重新授权 USB 调试、重新插拔设备;如果提示设备忙碌,关闭 Android Studio 并运行 adb kill-server 释放接口。
按症状排查
| 症状 | 优先检查 |
|---|---|
| 设备选择器里没有手机 | 数据线、文件传输模式、USB 调试、重新插拔 |
| 手机出现但无法授权 | 解锁屏幕、确认 RSA 指纹、撤销旧授权后重试 |
| 提示设备正忙 | 关闭 Android Studio、scrcpy 和桌面 ADB server |
| 曾经连接过但现在离线 | 刷新授权设备、重新连接 USB,必要时重新选择设备 |
| 关闭侧边栏后断开 | 这是当前会话边界;采集期间保持侧边栏打开 |
完整恢复顺序
- 换用已知支持数据传输的 USB 线和电脑 USB 端口。
- 在 Android 通知中选择文件传输。
- 关闭再开启 USB 调试,并撤销已有调试授权。
- 退出所有可能使用 ADB 的桌面程序。
- 重新插拔手机,在浏览器和手机上重新授权。
仍无法连接时记录什么
- 电脑操作系统和 Chrome/Edge 完整版本。
- 手机品牌、型号与 Android 版本。
- 浏览器选择器是否出现设备以及具体错误文案。
- 同一设备是否能被官方 adb devices 识别。
常见问题
为什么 Chrome 设备列表里没有 Android 手机?
优先确认 USB 线支持数据传输、手机 USB 用途为文件传输,并已开启 USB 调试;随后重新插拔手机并再次打开设备选择器。
为什么 WebUSB 提示设备正忙?
通常是 Android Studio、scrcpy 或桌面 ADB server 正在占用 USB ADB 接口。关闭相关程序并运行 adb kill-server 后重试。
为什么关闭 TabQA 侧边栏后连接会断开?
WebUSB 会话属于扩展侧边栏页面,关闭侧边栏会结束当前设备会话;已经保存的测试证据仍会保留。