可执行Jar运行报Clip空指针异常但Eclipse中正常运行求助

问题重现 #

在Eclipse中运行Java程序时无异常，但打包为可执行Jar后在GitBash执行出现以下错误：

$ javaw.exe -jar CookieClicker.jar
Exception in thread "main" java.lang.NullPointerException: Cannot invoke 
"javax.sound.sampled.Clip.setFramePosition(int)" because "this.clip" is null
    at com.tbonegames.SoundFX.play(SoundFX.java:51)
    at com.tbonegames.SoundFX.playSoundEffect(SoundFX.java:29)
    at com.tbonegames.CookieMain.<init>(CookieMain.java:73)
    at com.tbonegames.CookieMain.main(CookieMain.java:68)

核心原因 #

问题出在音频资源的加载方式差异：

• Eclipse运行时，项目的音频资源存储在本地文件系统的目录中（比如项目的resources文件夹），程序通过普通文件路径就能访问到资源，Clip对象能正常初始化，不会为null。
• 打包成Jar后，音频资源被嵌入到Jar包内部，不再是独立的本地文件，此时用普通文件路径无法读取资源，导致Clip初始化失败，最终为null，调用setFramePosition方法时触发NPE。

解决步骤 #

1. 修改音频资源加载代码 #

将原来基于本地文件的加载方式，改为使用类加载器读取Jar内的资源流：

// 错误写法（仅Eclipse可用）
File soundFile = new File("resources/click.wav");
AudioInputStream audioStream = AudioSystem.getAudioInputStream(soundFile);

// 正确写法（Eclipse和Jar通用）
// 注意路径开头的/代表类路径根目录，需匹配资源在Jar中的实际位置
InputStream inputStream = getClass().getResourceAsStream("/resources/click.wav");
if (inputStream == null) {
    throw new IllegalArgumentException("无法找到音频资源: /resources/click.wav");
}
AudioInputStream audioStream = AudioSystem.getAudioInputStream(inputStream);

2. 确保资源被正确打包进Jar #

• 在Eclipse中，将存放音频资源的文件夹标记为源文件夹：右键文件夹 → Build Path → Add to Build Path，这样导出Jar时会自动包含该文件夹下的所有资源。
• 导出可执行Jar时，在Eclipse的导出向导中，确认资源文件被勾选包含在Jar包内。

3. 验证资源路径正确性 #

可以通过打印资源URL来排查路径问题：

URL resourceUrl = getClass().getResource("/resources/click.wav");
System.out.println("资源URL: " + resourceUrl);

如果输出为null，说明路径错误，需打开Jar包（用压缩软件）查看资源的实际位置，调整路径匹配。

补充说明 #

Eclipse的运行环境会将项目的源目录和资源目录都加入类路径，资源以独立文件形式存在，因此普通文件路径能生效；而Jar包是一个压缩文件，内部资源必须通过类加载器的getResourceAsStream方法读取，这是Java读取Jar内资源的标准方式。

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