纯java播放ogg音频必须依赖jorbis或vorbisspi等第三方库，因jdk直到java 21仍不支持vorbis解码；jorbis轻量仅解码，vorbisspi封装为audiosystem spi但需注意依赖管理和java 9+模块化适配。
Java项目中引入JOrbis或VorbisSPI前先确认音频解码需求
纯Java播放OGG音频必须依赖第三方解码库，因为标准JDK（直到Java 21）仍不支持Vorbis编码的.ogg文件。JOrbis是纯Java实现的Ogg Vorbis解码器，轻量但仅支持解码；VorbisSPI则封装为AudioSystem SPI服务，能直接用AudioSystem.getAudioInputStream()加载，更贴近原生API习惯——但依赖tritonus_share和本地JNI（部分版本）。
使用VorbisSPI在Maven中正确声明依赖
VorbisSPI的Maven坐标容易配错：官方旧版（com.googlecode.soundlibs）已停更，推荐使用社区维护的com.github.tritonus分支。注意它强依赖tritonus-share，且需排除冲突的javax.sound传递依赖（尤其在Java 9+模块化环境下）：
<dependency><groupid>com.github.tritonus</groupid><artifactid>tritonus-vorbisspi</artifactid><version>0.3.7</version><exclusions><exclusion><groupid>javax.sound</groupid><artifactid>jsound</artifactid></exclusion></exclusions></dependency><dependency><groupid>com.github.tritonus</groupid><artifactid>tritonus-share</artifactid><version>0.3.7</version></dependency>
若用Gradle，对应写法需显式添加transitive = false控制传递依赖。
用AudioSystem加载OGG文件时的常见失败点
AudioSystem.getAudioInputStream()返回UnsupportedAudioFileException通常不是因为没加VorbisSPI，而是以下任一原因：
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- jar包未被JVM类路径识别（检查
java -cp是否包含vorbisspi.jar） - OGG文件实际是
Ogg Opus或Ogg FLAC封装（VorbisSPI只认Vorbis流） - Java 9+未启用
--add-opens java.desktop/sun.audio=ALL-UNNAMED（某些SPI注册机制触发内部反射） - 音频流采样率/位深超出
DataLine.Info支持范围（如48kHz立体声需手动重采样）
验证SPI是否生效可调用：
AudioSystem.getAudioFileTypes().stream()
.filter(type -> "OGG".equalsIgnoreCase(type.getExtension()))
.findAny(); // 应返回非empty
JOrbis手动解码适合需要精细控制的场景
当VorbisSPI因环境限制不可用，或需逐帧处理、跳转定位、获取元数据时，JOrbis更可控。它不依赖SPI，只需解析Ogg容器+Vorbis比特流：
- 用
OggInputStream读取原始.ogg字节流 - 用
VorbisDecoder提取AudioFormat和PCM样本 - 将解码后的
short[]喂给SourceDataLine播放
关键陷阱：JOrbis默认输出16-bit PCM，但SourceDataLine要求AudioFormat的encoding必须为AudioFormat.Encoding.PCM_SIGNED，且frameSize要匹配通道数×2（双声道即4字节/帧）。
OGG音频兼容性比MP3低得多，不同工具生成的Ogg头信息（如comment header顺序、vendor string长度）可能让某些Java解码器静默失败——建议用ffprobe -v quiet -show_entries stream=codec_name,codec_tag_string input.ogg确认确实是vorbis编码。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
