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 是阻塞式设计，适合简单播放；如需暂停/进度控制，得自己封装线程和缓冲。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
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 自身实现都有关联。
立即学习“Java免费学习笔记（深入）”；
-
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。
