0

0

Java如何处理UnsupportedAudioFileException异常 Java音频格式不支持解决方法【指南】

煙雲

煙雲

发布时间:2026-01-24 12:39:30

|

141人浏览过

|

来源于php中文网

原创

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

java如何处理unsupportedaudiofileexception异常 java音频格式不支持解决方法【指南】

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 的服务提供者:

Moonbeam
Moonbeam

经过专业培训的 AI 写作助手,可帮助您撰写各类长篇内容。

下载
  • 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
}

常见魔数参考:

  • RIFF52494646 → WAV ✅
  • ID3TAG 开头 → 很可能是 MP3 ❌(JDK 原生不认)
  • OggS4F676753 → 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() 的输入源是支持的 InputStreamURL —— 不能传入已关闭的流,也不能传入不支持 mark/reset 的流(如某些网络响应流),否则可能抛出其他异常掩盖真实问题。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

845

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

743

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

740

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

397

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

400

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

447

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

431

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16947

2023.08.03

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

25

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
SQL 教程
SQL 教程

共61课时 | 3.6万人学习

Java 教程
Java 教程

共578课时 | 50.5万人学习

oracle知识库
oracle知识库

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号