Java游戏项目音频播放异常求助：空指针与音频格式不支持

一、解决java.lang.NullPointerException（Clip.start()时clip为null） #

原因 #

1. 资源路径错误：getClass().getResource(path)返回null，导致后续AudioInputStream创建失败，clip未初始化就调用start()。
2. 多线程竞态冲突：clip作为Entity的成员变量被多个SoundPlayer线程共享，可能出现一个线程将clip置为null后，另一个线程尝试调用clip.start()的情况。

解决方法 #

1. 修正资源路径：
   你的项目中音频文件位于resources/res/sound/sound.wav，编译后resources下的文件会被放入classpath根目录，调用playSound时必须传入带开头斜杠的绝对路径：

   playSound("/res/sound/sound.wav");
   

2. 将clip改为线程局部变量：
   删除Entity类中的protected Clip clip;成员变量，把clip移到SoundPlayer内部，让每个线程持有独立的Clip实例：

   class SoundPlayer extends Thread {
       private URL soundFile;
       private Clip clip; // 线程局部变量，避免共享冲突
   
       public SoundPlayer(URL is) {
           this.soundFile = is;
       }
   
       @Override
       public void run() {
           try {
               AudioInputStream ais = AudioSystem.getAudioInputStream(soundFile);
               clip = AudioSystem.getClip();
               clip.open(ais);
               clip.start();
               // 播放完毕自动释放资源
               clip.addLineListener(event -> {
                   if (event.getType() == LineEvent.Type.STOP) {
                       clip.close();
                   }
               });
           } catch (Exception e) {
               e.printStackTrace();
           }
       }
   }
   

3. 增加资源存在性检查：
   在playSound方法中先判断URL是否为null，提前拦截错误：

   public synchronized void playSound(String path) {
       try {
           URL soundUrl = getClass().getResource(path);
           if (soundUrl == null) {
               System.err.println("音频文件未找到：" + path);
               return;
           }
           SoundPlayer sp = new SoundPlayer(soundUrl);
           sp.start();
       } catch (Exception e) {
           e.printStackTrace();
       }
   }
   

二、解决javax.sound.sampled.LineUnavailableException（不支持PCM_SIGNED 48000.0 Hz格式） #

原因 #

Java AudioSystem对部分高采样率音频格式的支持有限，或当前系统音频设备不兼容该格式，导致无法打开Clip。

解决方法 #

方法1：代码中转换音频格式

将音频流转换为系统兼容的标准格式（如44100Hz、16位），修改SoundPlayer的run方法：

@Override
public void run() {
    try {
        AudioInputStream originalAis = AudioSystem.getAudioInputStream(soundFile);
        AudioFormat originalFormat = originalAis.getFormat();

        // 定义目标兼容格式
        AudioFormat targetFormat = new AudioFormat(
                AudioFormat.Encoding.PCM_SIGNED,
                44100.0f,
                16,
                originalFormat.getChannels(),
                originalFormat.getChannels() * 2,
                44100.0f,
                false
        );

        // 转换格式
        AudioInputStream convertedAis = AudioSystem.getAudioInputStream(targetFormat, originalAis);

        clip = AudioSystem.getClip();
        clip.open(convertedAis);
        clip.start();

        // 播放完毕释放所有资源
        clip.addLineListener(event -> {
            if (event.getType() == LineEvent.Type.STOP) {
                clip.close();
                try {
                    convertedAis.close();
                    originalAis.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        });
    } catch (Exception e) {
        e.printStackTrace();
    }
}

方法2：预处理音频文件

用音频编辑工具（如Audacity）将sound.wav转换为44100Hz、16位、PCM编码的WAV格式，直接替换原文件，无需修改代码即可兼容。

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