JavaFX AudioClip播放Jar内音频报错：不支持file协议

错误1：UnsupportedOperationException: Unsupported protocol "file" #

问题场景 #

在IDE中运行简化代码时触发，代码通过Main.class.getResource()获取音频路径并传入AudioClip，但返回的file协议URL不被支持。

原因分析 #

• JavaFX媒体模块的native依赖未正确引入，导致协议处理器缺失。
• IDE环境中资源以文件形式存在而非Jar包内，AudioClip的native实现对file协议的处理存在兼容性问题。

解决方案 #

1. 正确配置Maven依赖
   确保引入对应平台的JavaFX媒体native依赖，以Windows为例：

   <dependencies>
       <dependency>
           <groupId>org.openjfx</groupId>
           <artifactId>javafx-media</artifactId>
           <version>20.0.1</version>
           <classifier>win</classifier>
       </dependency>
       <dependency>
           <groupId>org.openjfx</groupId>
           <artifactId>javafx-controls</artifactId>
           <version>20.0.1</version>
           <classifier>win</classifier>
       </dependency>
   </dependencies>
   

   或者使用javafx-maven-plugin自动管理平台依赖：

   <build>
       <plugins>
           <plugin>
               <groupId>org.openjfx</groupId>
               <artifactId>javafx-maven-plugin</artifactId>
               <version>0.0.8</version>
               <configuration>
                   <mainClass>main.Main</mainClass>
                   <modules>
                       <module>javafx.media</module>
                   </modules>
               </configuration>
           </plugin>
       </plugins>
   </build>
   

2. 打包后验证Jar协议
   打包成Jar后运行，此时getResource()会自动返回jar协议的URL，AudioClip可正常识别。若需在IDE中模拟Jar环境，可手动构建Jar协议URL：

   String resourcePath = Main.class.getResource("/sound/ambience/testSound.mp3").toExternalForm();
   String jarUrl = "jar:" + resourcePath + "!/sound/ambience/testSound.mp3";
   AudioClip clip = new AudioClip(jarUrl);
   

错误2：UnsatisfiedLinkError: no glib-lite in java.library.path #

问题场景 #

运行GitHub构建的Jar包时触发，提示无法找到glib-lite本地库。

原因分析 #

• JavaFX媒体依赖的native库未被加载，可能是运行时未指定native库路径，或JDK与JavaFX版本不兼容。
• 系统环境变量中存在多个JDK路径，导致加载了错误版本的native库。

解决方案 #

1. 统一JDK与JavaFX版本
   使用与JavaFX版本匹配的JDK，例如JavaFX 20.0.1搭配Zulu 20，避免跨版本兼容问题。

2. 指定native库路径运行
   运行Jar包时，通过参数指定JavaFX native库的路径：

   java --module-path "path/to/javafx-sdk-20.0.1/lib" --add-modules javafx.media -jar your-app.jar
   

3. 清理系统环境变量
   移除环境变量PATH中多余的JDK路径，确保优先使用目标JDK（如Zulu 20）的bin目录，避免库加载冲突。

4. 打包时包含native库
   使用javafx-maven-plugin的jlink功能生成包含native库的运行镜像，或手动将native库复制到Jar包所在目录，确保运行时能自动加载。

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