知识库/参考文档/WSL USB 设备消失问题

WSL USB 设备消失问题

感谢 Xiaoyu Wang的分享

现象:wsl2,usbipd wsl attach之后,本来wsl2里面可以看到设备,但是拔插一次,连设备管理器里也看不到了

一、问题原因

usbipd 的持久化绑定机制

usbipd 为了让某个 USB 设备能长期共享,会在系统里保存一个 Persisted 记录。

一旦设备被标记成共享状态,Windows 本地驱动就不再接管该设备。

异常的残留绑定

当设备更换插口、VID/PID 同类、或者 usbipd 服务异常退出时,持久记录没有同步清理。

系统认定该设备仍由 usbipd 接管,于是从设备管理器里“消失”,串口号不再出现。

注册表已经不是唯一存储位置

新版本 usbipd(5.x 起)不再用注册表,而是用磁盘文件保存持久化信息。

因此,删除旧版本路径不会生效,看起来“删不掉 Persisted”。

⚙️ 二、解决原理

解绑(Unbind)

删除 usbipd 的持久化记录,让系统重新把设备还给本地驱动。

刷新服务

重启 usbipd 服务使内部数据库重新加载,去除已解除的绑定状态。

彻底清空数据库

当记录损坏或者指向不存在设备时,直接移除 usbipd 的配置目录,相当于重置它的状态机。