如何解决Java中org.usb4java.javax.Services未找到错误？

问题原因 #

javax.usb:usb-api仅为USB操作的API定义层，不包含具体实现逻辑。报错提示找不到org.usb4java.javax.Services，本质是缺少了usb4java这个javax.usb的具体实现依赖库。

解决步骤 #

1. 添加usb4java-javax依赖 #

如果使用Maven，在pom.xml中添加：

<dependency>
    <groupId>org.usb4java</groupId>
    <artifactId>usb4java-javax</artifactId>
    <version>1.3.0</version>
</dependency>

如果使用Gradle，在build.gradle中添加：

implementation 'org.usb4java:usb4java-javax:1.3.0'

2. 安装MacOS原生依赖libusb #

usb4java依赖系统级的libusb库，通过Homebrew安装：

brew install libusb

3. 验证USB访问权限（可选） #

MacOS对USB设备访问有权限限制，开发阶段可尝试用sudo运行Java程序，排查是否为权限问题。后续可通过配置应用权限避免使用sudo。

4. 指定原生库路径（可选） #

若安装libusb后仍找不到原生库，可通过VM参数指定路径：

-Djava.library.path=/usr/local/lib

（Homebrew安装的libusb默认位于此路径）

内容的提问来源于stack exchange，提问作者kanishka