JavaFX加载MP3音频触发IllegalArgumentException错误求助

错误原因 #

Media 类的构造参数要求传入带协议头的标准URI字符串，直接传入资源相对路径sounds/menu_music.mp3时，路径没有对应的协议标识（如本地文件的file:、jar包资源的jar:），因此抛出uri.getScheme() == null异常。

正确实现方式 #

你存放的音频属于类路径资源，需要先通过类加载器获取资源的合法URI，再传入Media构造方法，示例代码如下：

// 路径前加 / 表示从类路径根目录开始匹配资源
URL audioResource = getClass().getResource("/sounds/menu_music.mp3");
// 增加空校验提前发现资源路径配置问题
if (audioResource == null) {
    throw new RuntimeException("音频资源未找到，请检查文件路径和资源目录配置");
}
Media menuMusic = new Media(audioResource.toExternalForm());
menuPlayer = new MediaPlayer(menuMusic);
menuPlayer.setAutoPlay(true);
menuPlayer.setVolume(0.8);

注意事项 #

• 确保你的res目录已经被IDE标记为资源根目录：IDEA中右键res目录 → 选择Mark Directory as → 勾选Resources Root；Eclipse中将res目录加入项目的Build Path，否则编译后资源不会被复制到类路径下，会返回空指针。
• 该写法同时适配本地开发运行、打包成jar包运行两种场景，不需要额外修改路径配置。

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