Java按钮点击播放WAV音频报UnsupportedAudioFileException如何解决

错误1：UnsupportedAudioFileException 原因&解决 #

• 格式不兼容：Java Sound原生仅支持16位PCM编码的WAV文件，如果你当前的WAV是ADPCM、浮点编码、或者是其他格式改后缀得到的伪WAV，都会触发这个报错。你可以用Audacity打开音频文件，导出为「WAV(Microsoft) 16位PCM」格式即可解决。
• 路径校验缺失：你当前的代码没有校验文件是否存在，可能是路径拼写错误导致找不到文件。可以在AudioInputStream初始化前新增文件存在性校验：

File file = new File(soundFileName);
// 新增校验逻辑
if (!file.exists() || !file.isFile()) {
    System.out.println("音频文件不存在，路径错误：" + soundFileName);
    return;
}
AudioInputStream rickRoll = AudioSystem.getAudioInputStream(file);

• 大小写校验：虽然Windows系统不区分文件名大小写，还是建议确认本地文件后缀和代码中写的.WAV完全一致。

错误2：NullPointerException 原因&解决 #

这个是第一个错误的连锁反应：加载音频失败后，clip对象没有完成初始化，直接调用clip.setFramePosition(0)就会触发空指针。修复方案：

1. 新增加载状态判断，加载成功才执行播放逻辑，同时优化加载逻辑，避免每次点击按钮都重复加载音频：

// 可以在RickRoll构造方法中提前加载音频，不要每次点击都加载
public RickRoll() {
    // 原有构造逻辑不变
    rRSound = "C:\\Users\\bduncan0856\\Desktop\\Sounds\\rickRoll.WAV";
    // 初始化时就加载音频
    rRS.setFile(rRSound);
}

public class RickRollSound {
    Clip clip;
    // 新增方法判断是否加载成功
    public boolean isLoaded() {
        return clip != null && clip.isOpen();
    }
    
    public void play() {
        if (isLoaded()) {
            clip.setFramePosition(0);
            clip.start();
        } else {
            System.out.println("音频未加载成功，无法播放");
        }
    }
}

// 点击事件直接播放即可
public void actionPerformed(ActionEvent event) {
    rRS.play();
}

额外优化建议 #

• 后续发布应用时不要用绝对路径，把音频文件放到项目资源目录下，用类加载器读取资源，避免换设备路径失效的问题。
• 播放完成后记得调用clip.close()释放资源，避免内存泄漏。

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