纯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+模块化环境下）：
com.github.tritonus tritonus-vorbisspi 0.3.7 javax.sound jsound com.github.tritonus tritonus-share 0.3.7
若用Gradle，对应写法需显式添加transitive = false控制传递依赖。
用AudioSystem加载OGG文件时的常见失败点
AudioSystem.getAudioInputStream()返回UnsupportedAudioFileException通常不是因为没加VorbisSPI，而是以下任一原因：
立即学习“Java免费学习笔记（深入）”；
- 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编码。
