连接排障

Chrome 找不到 Android 手机时检查什么

多数 WebUSB 连接问题来自数据线、USB 模式、调试授权或桌面 ADB 占用。

直接答案

先确认数据线支持传输、手机 USB 用途是文件传输且 USB 调试已开启。如果设备仍不出现,撤销并重新授权 USB 调试、重新插拔设备;如果提示设备忙碌,关闭 Android Studio 并运行 adb kill-server 释放接口。

按症状排查

症状优先检查
设备选择器里没有手机数据线、文件传输模式、USB 调试、重新插拔
手机出现但无法授权解锁屏幕、确认 RSA 指纹、撤销旧授权后重试
提示设备正忙关闭 Android Studio、scrcpy 和桌面 ADB server
曾经连接过但现在离线刷新授权设备、重新连接 USB,必要时重新选择设备
关闭侧边栏后断开这是当前会话边界;采集期间保持侧边栏打开

完整恢复顺序

  1. 换用已知支持数据传输的 USB 线和电脑 USB 端口。
  2. 在 Android 通知中选择文件传输。
  3. 关闭再开启 USB 调试,并撤销已有调试授权。
  4. 退出所有可能使用 ADB 的桌面程序。
  5. 重新插拔手机,在浏览器和手机上重新授权。

仍无法连接时记录什么

  • 电脑操作系统和 Chrome/Edge 完整版本。
  • 手机品牌、型号与 Android 版本。
  • 浏览器选择器是否出现设备以及具体错误文案。
  • 同一设备是否能被官方 adb devices 识别。

常见问题

为什么 Chrome 设备列表里没有 Android 手机?

优先确认 USB 线支持数据传输、手机 USB 用途为文件传输,并已开启 USB 调试;随后重新插拔手机并再次打开设备选择器。

为什么 WebUSB 提示设备正忙?

通常是 Android Studio、scrcpy 或桌面 ADB server 正在占用 USB ADB 接口。关闭相关程序并运行 adb kill-server 后重试。

为什么关闭 TabQA 侧边栏后连接会断开?

WebUSB 会话属于扩展侧边栏页面,关闭侧边栏会结束当前设备会话;已经保存的测试证据仍会保留。

来源与依据