Eclipse中JavaFX导入mp3作为AudioClip报错如何解决

这个IllegalAccessError和mp3文件导入逻辑无关，是JDK9及以上版本引入模块系统后，非模块化项目（运行在unnamed module）调用JavaFX媒体组件时，JavaFX默认不向未命名模块开放内部依赖包访问权限导致的。

第一步：修复模块访问权限报错 #

两种方案二选一即可：

• 方案1：添加VM运行参数（快速修复，不用改项目结构）
  1. 在Eclipse中右键项目，选择Run As -> Run Configurations
  2. 切换到Arguments标签，在VM arguments输入框中填入以下参数：

     --add-exports javafx.graphics/com.sun.glass.utils=ALL-UNNAMED
     

  3. 点击Apply保存配置后重新运行即可。
• 方案2：配置模块化项目（长期稳定方案，推荐）
  1. 在项目src源码根目录新建module-info.java模块声明文件
  2. 写入以下基础配置，替换成你自己的包名：

     module 你的项目模块名 {
         requires javafx.controls;
         requires javafx.media; // AudioClip所属模块，必须引入
         // 资源所在包开放给javafx.media模块，音频放在类路径根目录就写下面这行
         opens / to javafx.media;
         // 音频放在com.yourgame.assets包下就替换为 opens com.yourgame.assets to javafx.media;
         exports 主类所在的业务包名;
     }
     

  3. 保存后Eclipse会自动识别模块路径，无需额外添加VM参数，模块访问报错会直接消失。

第二步：正确导入mp3资源避免加载失败 #

• 资源存放规范：不要把mp3文件直接放在项目根目录，在src目录下新建资源文件夹，右键该文件夹选择Build Path -> Use as Source Folder标记为源码根目录，把OWMusic.mp3放入该文件夹即可。
• 你写的初始化代码public AudioClip OWMusic = new AudioClip(getClass().getResource("/OWMusic.mp3").toExternalForm());本身逻辑正确，只要文件确实在类路径根目录即可正常加载，注意核对文件名大小写，避免跨系统运行时出现资源找不到的问题。
• 补充说明：AudioClip适合加载10秒以内的短音效，如果是长背景音乐，建议替换为MediaPlayer实现，长音频用AudioClip会占用过高内存；mp3文件尽量使用标准CBR编码的128/320kbps规格，避免特殊编码导致解码失败。

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