JAVE2 转音频本质是调用本地 ffmpeg，需确保其可执行且路径正确；Windows 常因 PATH 未配置或 IDE 启动丢失环境变量导致失败；Linux/macOS 需 chmod +x 授予执行权限；编码器、比特率等必须显式设置，否则音质劣化或转码失败。
Java 用 JAVE2 转音频格式，本质是调用本地 ffmpeg 命令行，不是纯 Java 解码——所以第一步必须确认 ffmpeg 可执行文件已正确安装并能被 Java 进程访问到，否则所有转换都会静默失败或抛出 NoClassDefFoundError / IOException: Cannot run program "ffmpeg"。
确认 ffmpeg 是否可用且路径正确
JAVE2 默认会在系统 PATH 中查找 ffmpeg，但 Windows 常见问题是：装了 ffmpeg 却没配环境变量，或配了但 Java 启动时没继承（比如 IDE 启动方式导致 PATH 丢失）。
- 在终端直接运行
ffmpeg -version，确认有输出 - 如果用的是自定义路径（如
D:\tools\ffmpeg\bin\ffmpeg.exe），必须显式传入：AudiAttributes audio = new AudioAttributes(); AudioAttributes audio = new AudioAttributes(); Encoder encoder = new Encoder(new MultimediaObject(new File("input.mp3")), new DefaultFFMPEGLocator("D:\\tools\\ffmpeg\\bin\\ffmpeg.exe")); - Linux/macOS 注意权限：
chmod +x /path/to/ffmpeg，否则会报Permission denied
转 MP3 → WAV 或 AAC → MP3 的典型写法
核心是设置 AudioAttributes 的编码器、比特率、采样率等；JAVE2 不自动推断目标格式，必须靠输出文件扩展名 + EncodingAttributes 显式指定。
- 输出扩展名决定容器格式（
.wav≠ PCM 编码，只是常见封装） - 实际音频编码由
audio.setCodec("libmp3lame")或"pcm_s16le"控制 - 不设
audio.setBitRate(128000)时，部分编码器会用极低默认值（如 64k），音质明显劣化
File source = new File("input.aac
");
File target = new File("output.mp3");
AudioAttributes audio = new AudioAttributes();
audio.setCodec("libmp3lame");
audio.setBitRate(128000);
audio.setChannels(2);
audio.setSamplingRate(44100);
EncodingAttributes attrs = new EncodingAttributes();
attrs.setOutputFormat("mp3");
attrs.setAudioAttributes(audio);
Encoder encoder = new Encoder();
encoder.encode(new MultimediaObject(source), target, attrs);
常见失败原因和绕过技巧
很多“转不了”不是代码问题，而是 ffmpeg 缺失依赖或参数冲突。
- 报错
Unknown encoder 'libmp3lame'：说明 ffmpeg 编译时没启用 lame 支持，换用"aac"或改用系统自带的"libfdk_aac"（需 ffmpeg 重编译） - 输入文件路径含中文或空格：务必用
new File("路径").getAbsolutePath()，否则JAVE2内部拼接命令行会出错 - 内存溢出（OOM）：大文件转码时
JAVE2会把整个过程日志缓存在内存，建议加encoder.setProgressListener(...)并定期清空缓冲 - WAV 转 MP3 失败：WAV 可能是 24bit 或 float 样本，而
libmp3lame只支持 16bit，需先用audio.setCodec("pcm_s16le")强制重采样
真正卡住的地方往往不是 Java 代码，而是 ffmpeg 的可执行性、编码器可用性、以及输入音频的原始属性是否被目标编码器接受——建议先在命令行手动跑通等效命令，再照搬参数到 JAVE2。
