2026-06-02

libusb Access Denied 与 WinUSB 驱动调试：权限、Zadig、内核驱动与 USB Claim

排查 libusb Access Denied、WinUSB 驱动未绑定、Zadig 驱动安装问题、内核驱动 Claim、权限、USB 接口访问失败。

USB 开发工具经常报 LIBUSB_ERROR_ACCESS、"access denied"、"cannot claim interface"、"WinUSB driver not found"、"Zadig driver install failed"、"resource already exists"。设备在 OS 里能看到，但诊断或固件工具打不开的时候，用户搜 "libusb access denied"、"WinUSB driver not binding"、"Zadig failed"、"libusb cannot claim interface"、"USB permission denied"。

Bus Scope 在这个场景下有用，因为访问问题夹在 USB 描述符、操作系统驱动绑定和应用层接口 Claim 之间。设备可以物理连上、正确枚举，但 libusb 仍然打不开。

设备存在 ≠ 接口可访问

USB 设备可能正确枚举：

Device Descriptor 读到
Configuration 选中
接口可见
端点已描述
操作系统显示设备

但 libusb 还是打不开、Claim 不上目标接口——因为别的驱动占着、权限缺失、WinUSB 没绑上、或者应用认错了接口。

Windows 与 WinUSB

在 Windows 上，libusb 风格的访问通常要求一个兼容驱动（比如 WinUSB）绑到目标接口。Zadig 这类工具常被用来替换或安装一个厂商自定义接口的驱动。

常见问题：

Zadig 里选错了接口
组合设备有多个接口
HID 驱动占着接口
现有驱动包冲突
驱动安装被策略挡住
Bootloader 模式下设备暴露了不同的 VID/PID
Microsoft OS Descriptor 指向了错的接口

对组合设备来说，换错接口的驱动不但修不好目标工具，还可能破坏另一个功能。

Linux 权限

在 Linux 上，LIBUSB_ERROR_ACCESS 常常意味着用户没权限打开设备节点。设备在，但 udev 规则或用户组成员关系不允许访问。

Trace 能显示 USB 流量是存在的，但权限错误可能还需要操作系统层的证据。区分：

设备没枚举
设备枚举了但没权限
内核驱动已经绑上
应用认错了 VID/PID 或接口

内核驱动已经 Claim 了接口

如果一个内核驱动占着接口，libusb 可能需要 Detach 它，或者应用得改用内核驱动 API。HID、CDC、Storage、Audio 接口常被 inbox 驱动 Claim。

安全的答案要看产品意图。对键盘或存储设备，Detach 内核驱动会扰乱系统正常行为。对厂商自定义诊断接口，WinUSB/libusb 绑定就是对的。

排查清单

按这个流程：

抓枚举和描述符
识别目标 Interface 编号
看设备是不是组合设备
Windows 上确认驱动是不是绑到了那个接口
Linux 上确认权限和 udev 规则
看是不是已经有内核驱动占着接口
校验 VID/PID 在普通模式和 Bootloader 模式下
确认应用认的是正确的接口
不要给无关接口换驱动
改驱动绑定之前保留描述符证据

最终诊断

libusb access denied 和 WinUSB 绑定失败通常不是裸的 USB 信号问题。它们是接口归属、权限、驱动绑定或描述符映射的问题。