WebUSB无法识别Windows设备：Android与Windows通信故障求助

核心问题分析 #

你遇到的情况是PC能识别手机，但手机端（作为WebUSB主机）无法识别PC，核心原因通常是PC未被配置为符合WebUSB要求的USB设备，或驱动、参数配置不匹配。

具体排查与解决步骤 #

1. 确认PC端USB设备配置与WinUSB驱动 #

• Windows默认是USB主机角色，需将PC切换为USB设备模式：借助Zadig工具将目标USB设备的驱动替换为WinUSB，确保系统用WinUSB驱动该设备。
• 核对设备ID：代码中vendorId: 8921（十六进制为0x22E9），需确认PC端USB设备的实际Vendor ID与该值一致；若不一致，修改代码中的vendorId为PC设备的真实ID，或调整PC设备的配置匹配该ID。

2. 检查Android端WebUSB运行条件 #

• 浏览器支持：使用Chrome 61及以上版本（仅这些版本支持WebUSB），且网站需在HTTPS环境下运行（本地调试可使用localhost）。
• 系统权限：在Android开发者选项中启用USB调试和USB主机模式（部分设备需手动开启）；调用requestDevice时，务必授予网站访问USB设备的权限。

3. 验证PC设备的WebUSB兼容性 #

• WebUSB要求设备包含WebUSB平台描述符，浏览器才能识别为兼容设备。可通过libusb工具查看设备描述符，确认是否存在该描述符。
• 若为自定义USB设备，需在PC端的设备配置中添加WebUSB描述符，确保浏览器能检测到。

4. 调试与定位具体错误 #

• 打开Android浏览器的开发者工具，查看控制台输出的错误信息：是设备未找到、权限不足还是无法打开设备，根据错误信息针对性解决。
• 临时移除filters参数，调用navigator.usb.requestDevice({ filters: [] })，查看是否能列出PC的USB设备，以此判断是ID匹配问题还是设备未被识别。

代码调试建议 #

可以修改代码增加错误详情输出，方便定位：

navigator.usb
    .requestDevice({ filters: [{vendorId: 8921}]})
    .then(device => {
        console.log('Found a device:', device);
        console.log('Device vendorId:', device.vendorId, 'productId:', device.productId);
        return device.open();
    })
    .then(() => {
        console.log('Device opened successfully');
    })
    .catch(error => {
        console.error('Error details:', error);
        console.error('Error message:', error.message);
    })

内容的提问来源于stack exchange，提问作者pepa z depa