Java用JLayer播放MP3教程及源码分享

Java无法直接播放MP3，因javax.sound.sampled不支持压缩格式；须用JLayer解码为PCM后通过SourceDataLine输出，注意中文路径、缓冲区管理和资源释放。

Java 本身不原生支持 MP3 解码播放，javax.sound.sampled 只能处理 WAV、AIFF 等无压缩格式。想直接播放 MP3 文件，必须借助第三方解码库——JLayer 是最轻量、最常用的选择，但它只负责解码，不提供音频输出能力，需手动对接 SourceDataLine。

为什么不能直接用 AudioSystem.play() 播放 MP3

AudioSystem.getAudioInputStream() 对 MP3 文件会抛出 UnsupportedAudioFileException，因为 JDK 内置的音频服务提供者（SPI）默认不注册 MP3 解码器。即使你把 MP3 文件路径传给 Clip 或 AudioSystem.play()，也会静默失败或报错。

• 常见错误信息：javax.sound.sampled.UnsupportedAudioFileException: could not get audio input stream from input URL
• 不是路径写错，是格式不被识别
• 别试图用 FileInputStream + AudioFormat 手动构造流——MP3 是有损压缩格式，必须先解码成 PCM

用 JLayer 解码 + SourceDataLine 播放的最小可行代码

核心逻辑：用 Player 类逐帧解码 MP3 为 PCM 字节数组，再通过 SourceDataLine 实时写入声卡。注意 JLayer 的 Player 是阻塞式设计，适合简单播放；如需暂停/进度控制，得自己封装线程和缓冲。

import javazoom.jl.player.Player;
import javax.sound.sampled.*;
import java.io.FileInputStream;

public class MP3Player {
    public static void play(String mp3Path) throws Exception {
        FileInputStream fis = new FileInputStream(mp3Path);
        Player player = new Player(fis);

        // 获取 MP3 的采样率、位深、声道数（JLayer 会自动解析）
        // 但注意：JLayer 默认输出为 44100Hz、16-bit、stereo 的 PCM
        AudioFormat format = new AudioFormat(
            AudioFormat.Encoding.PCM_SIGNED,
            44100, 16, 2, 4, 44100, false
        );

        DataLine.Info info = new DataLine.Info(SourceDataLine.class, format);
        SourceDataLine line = (SourceDataLine) AudioSystem.getLine(info);
        line.open(format);
        line.start();

        // 将解码后的 PCM 数据写入声卡
        byte[] buffer = new byte[4096];
        while (player.read(buffer) != -1) {
            line.write(buffer, 0, buffer.length);
        }

        line.drain();
        line.close();
        player.close();
        fis.close();
    }
}

• 依赖需添加：javazoom:jlayer:1.0.1（Maven）或下载 jlayer-1.0.1.jar 手动引入
• buffer 大小影响延迟和 CPU 占用：太小（如 1024）易卡顿；太大（如 16384）增加启动延迟
• 该代码不处理异常中断（如用户关机），line.drain() 必须调用，否则末尾几毫秒声音会被截断

JLayer 播放常见坑与绕过方式

实际项目中容易卡在三个地方：中文路径乱码、播放卡顿、无法释放资源。这些问题和 JDK 版本、系统音频驱动、JLayer 自身实现都有关联。

• FileNotFoundException 但路径明明存在？→ Windows 下用 FileInputStream 读含中文路径的 MP3 会因编码问题失败，改用 Files.newInputStream(Paths.get(mp3Path))
• 播放中途卡住不动？→ 多半是 SourceDataLine.write() 阻塞了，说明声卡缓冲区满。加个非阻塞检测：if (line.available() < buffer.length) Thread.sleep(1);
• 重复播放同一文件后声音变小或失真？→ SourceDataLine 未 close 导致设备被占用，下次 open 失败而降级到软件混音。务必确保 finally 块里调用 line.close() 和 player.close()
• 想播放网络 MP3（如 URL）？→ JLayer.Player 构造函数只接受 InputStream，可传 url.openStream()，但需自行处理 HTTP 超时和重定向

真正难的不是“怎么播出来”，而是“怎么播得稳、停得准、切得顺”。JLayer + SourceDataLine 组合没有内置事件回调，所有播放状态（是否结束、当前毫秒数）都要靠你自己计时、读取帧数、甚至反查 ID3 标签里的时长字段。如果项目需要暂停/拖动/多音轨，建议直接上 JavaFX MediaPlayer（支持 MP3，但需模块化运行时）或转 JNI 调用 libvlc。