JDK原生仅支持.wav、.aif/.aiff、.au格式;MP3及FLAC、OGG等均不支持,需通过mp3spi等SPI库扩展,或用FFmpeg转码。

Java 的 UnsupportedAudioFileException 表示 AudioSystem.getAudioInputStream() 无法识别或解析你提供的音频文件格式——不是文件损坏,而是 JDK 原生不支持该编码或容器。
哪些格式默认被 JDK 支持?
JDK(包括 OpenJDK 和 Oracle JDK)仅原生支持有限的几种格式:
-
.wav(PCM 编码,RIFF 容器)✅ -
.aif/.aiff(AIFF 格式)✅ -
.au(Sun Audio)✅ -
.mp3❌(JDK 从不原生支持,即使文件能被系统播放) -
.flac、.ogg、.m4a、.wma等全部 ❌
注意:AudioSystem.getAudioInputStream(new File("xxx.mp3")) 会直接抛出 UnsupportedAudioFileException,这不是 bug,是设计如此。
用第三方库扩展支持(推荐方案)
最稳定、轻量、广泛使用的方案是引入 javax.sound.sampled 的扩展实现:TarsosDSP 或更主流的 jl(MP3)、tritonus(FLAC/AAC),但目前维护最活跃、集成最简单的是 javazoom.jl + 自定义 AudioInputStream 包装。
立即学习“Java免费学习笔记(深入)”;
以 MP3 为例,添加 Maven 依赖:
javazoom jl 1.0.1
然后手动桥接为标准 AudioInputStream:
import javazoom.jl.decoder.JavaLayerException;
import javazoom.jl.player.AudioDevice;
import javazoom.jl.player.advanced.AdvancedPlayer;
import javax.sound.sampled.*;
import java.io.*;
public class Mp3AudioInputStream extends AudioInputStream {
private final AdvancedPlayer player;
private final AudioFormat format;
public Mp3AudioInputStream(InputStream in) throws JavaLayerException {
super(new ByteArrayInputStream(new byte[0]),
new AudioFormat(AudioFormat.Encoding.PCM_SIGNED,
44100, 16, 2, 4, 44100, false),
AudioSystem.NOT_SPECIFIED);
this.player = new AdvancedPlayer(in);
// 实际项目中需另起线程解码并缓存 PCM 数据,此处仅为示意结构
this.format = new AudioFormat(
AudioFormat.Encoding.PCM_SIGNED, 44100, 16, 2, 4, 44100, false);
}
// ⚠️ 注意:真实使用需完整实现 read(), available(), close() 等方法
// 推荐直接使用封装好的工具类,如 mp3spi(见下条)
}
更省心的做法:改用 mp3spi(基于 jl 的 SPI 实现),它会自动注册为 AudioSystem 的服务提供者:
- Maven 添加:
com.googlecode.soundlibs:mp3spi:1.9.5.4 - 之后无需修改代码,
AudioSystem.getAudioInputStream(file)就能直接读 MP3 - 同理,
flacspi支持 FLAC,oggspi支持 Ogg Vorbis
检查文件头和实际编码是否匹配
有时异常并非因为格式不支持,而是文件扩展名与真实内容不符(比如把 AAC 文件重命名为 .wav)。可用命令行快速验证:
file your_audio.xxx
或 Java 中读取前几个字节判断魔数:
byte[] header = new byte[4];
try (FileInputStream fis = new FileInputStream(file)) {
fis.read(header);
String hex = String.format("%02X%02X%02X%02X", header[0], header[1], header[2], header[3]);
System.out.println("Header: " + hex); // e.g., "52494646" → "RIFF" → WAV
}
常见魔数参考:
-
RIFF→52494646→ WAV ✅ -
ID3或TAG开头 → 很可能是 MP3 ❌(JDK 原生不认) -
OggS→4F676753→ Ogg Vorbis ❌
绕过 AudioSystem:用 FFmpeg 命令行转码(适合离线预处理)
如果只是偶尔处理非标准格式,且允许外部依赖,用 ffmpeg 转成 WAV 是最可靠的方式:
ffmpeg -i input.mp3 -ar 44100 -ac 2 -f wav output.wav
Java 中调用执行(注意路径和错误流捕获):
ProcessBuilder pb = new ProcessBuilder("ffmpeg", "-i", "input.mp3",
"-ar", "44100", "-ac", "2", "-f", "wav", "output.wav");
pb.redirectErrorStream(true);
Process p = pb.start();
p.waitFor();
优点:100% 格式兼容;缺点:强依赖外部二进制、无跨平台保证、不适合高频实时场景。
真正容易被忽略的一点:即使加了 mp3spi,也必须确保 AudioSystem.getAudioInputStream() 的输入源是支持的 InputStream 或 URL —— 不能传入已关闭的流,也不能传入不支持 mark/reset 的流(如某些网络响应流),否则可能抛出其他异常掩盖真实问题。










