导出JAR运行时MediaException:MEDIA_UNAVAILABLE问题求助

我一眼就看出问题所在了——你现在用File类来加载音频资源，这在Eclipse本地运行时没问题，因为此时resources目录是文件系统里的真实文件夹；但导出成可执行JAR后，所有资源都被打包进了JAR包内部，不再是独立的文件，File自然找不到它们。而且正如你提到的，JavaFX的Media只支持HTTP、FILE和JAR类型的URI，所以我们得改用类路径资源加载的方式来生成合法的JAR URI。

问题根源拆解 #

你的错误日志显示程序在桌面目录下找resources/data/music/...，但实际上这些文件已经被打包进JAR里了，根本不在桌面的文件系统中。File只能访问文件系统中的实体文件，无法读取JAR包内部的资源，这就是核心矛盾。

解决方案：改用类加载器获取资源URL #

我们可以通过类加载器的getResource()方法来获取JAR内部资源的URL，这个方法会自动处理JAR内的路径，生成符合Media要求的JAR格式URI。

修改你的代码：

原来的代码：

gameMusic = new Media(new File("resources/data/music/Kevin_MacLeod_-_Ouroboros_-_Full_Mix.wav").toURI().toString());
bulletSound = new AudioClip(new File("resources/data/music/Photon gun shot.wav").toURI().toString());
explosionSound = new AudioClip(new File("resources/data/music/Explosion+3.wav").toURI().toString());

替换为：

// 加载背景音乐，注意路径开头的斜杠表示类路径根目录
URL gameMusicUrl = Main.class.getResource("/data/music/Kevin_MacLeod_-_Ouroboros_-_Full_Mix.wav");
if (gameMusicUrl == null) {
    throw new IllegalArgumentException("找不到背景音乐文件，请检查路径是否正确: /data/music/Kevin_MacLeod_-_Ouroboros_-_Full_Mix.wav");
}
gameMusic = new Media(gameMusicUrl.toString());

// 加载音效文件
bulletSound = new AudioClip(Main.class.getResource("/data/music/Photon gun shot.wav").toString());
explosionSound = new AudioClip(Main.class.getResource("/data/music/Explosion+3.wav").toString());

关键注意事项 #

• 路径格式：路径开头的/非常重要，它代表从类路径的根目录开始查找。因为你的resources是Eclipse的源文件夹，编译后里面的data目录会直接放在类路径根下，所以路径应该是/data/music/xxx.wav，而不是resources/data/music/xxx.wav。
• 验证资源是否被打包：导出JAR时，一定要确认data/music下的音频文件被包含在JAR中。你可以用压缩软件打开JAR包，检查是否存在data/music目录和对应的文件。
• 大小写问题：JAR内部的路径是区分大小写的，而Windows文件系统不区分。如果你的文件名或目录名大小写不一致，在Eclipse里可能正常，但JAR运行时会找不到资源，这点要特别注意。
• Eclipse源文件夹设置：确保resources目录在Eclipse中被标记为Source Folder（右键目录 → Build Path → Use as Source Folder），这样编译时Eclipse才会把里面的文件复制到类路径输出目录（比如bin或target/classes）。

这样修改后，不管是在Eclipse中运行，还是导出成可执行JAR，都能正确加载音频资源了。

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