Java AudioSystem 怎样判断音频格式是否支持转换

Java 判断音频格式能不能转换，最直接的入口是 AudioSystem.isConversionSupported：已经知道目标和源的完整 AudioFormat 时，调用完整格式重载；只关心目标编码时，调用编码重载。不要只看文件扩展名，也不要直接调用转换方法再用异常当作唯一探测手段。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/sound/sampled/AudioSystem.html

先得到真实的源格式，再按“编码是否可达—完整格式是否可达—目标文件类型能否写出”三层判断。返回 true 只表示 Java Sound 当前安装的转换器报告支持，最终转换仍要处理输入损坏、资源限制和输出失败。

先分清要判断的三种能力

AudioSystem 把“播放或录音线路”“音频流格式转换”和“文件容器写出”分成不同 API。本文标题里的格式转换，核心是把源 AudioFormat 转成目标格式；它不等同于把 WAV 扩展名改成另一种扩展名。

这层区分很重要：编码判断通过，不代表你指定的 48 kHz、双声道、16 位小端格式也一定通过；完整格式判断通过，也不代表目标容器一定能由当前实现写出。

已知源格式时，直接判断完整转换

如果业务已经从文件头或输入流获得了源格式，就把目标与源一起交给完整格式重载。下面的辅助方法只做能力查询，不创建转换流；这样可以把“是否支持”与“实际转换”分成两个明确边界。

import javax.sound.sampled.AudioFormat;
import javax.sound.sampled.AudioSystem;

final class AudioConversionGuard {
    private AudioConversionGuard() {
        // 工具类不需要实例化。
    }

    static boolean supports(AudioFormat source, AudioFormat target) {
        if (source == null || target == null) {
            // 调用方应先完成输入解析，避免把空格式交给 Java Sound。
            return false;
        }
        // 完整格式判断会同时考虑编码、采样率、位深和声道等字段。
        return AudioSystem.isConversionSupported(target, source);
    }

    static boolean supportsEncoding(AudioFormat source,
                                    AudioFormat.Encoding targetEncoding) {
        if (source == null || targetEncoding == null) {
            // 空参数不是“不支持”，而是调用边界没有准备好。
            return false;
        }
        // 这里只问目标编码是否可达，不承诺某个具体采样参数组合。
        return AudioSystem.isConversionSupported(targetEncoding, source);
    }
}

两个重载的参数顺序都是“目标在前、源在后”。调用时最容易犯的错误是把它们反过来，结果查询了另一条方向。还要注意：返回 true 后再调用 getAudioInputStream，该转换方法仍可能因为输入流本身无效而抛出异常。

不知道目标细节时，先列出可达范围

有些业务只规定“转成某种编码”，并没有固定采样率或声道。这时可以先调用 getTargetEncodings(sourceFormat)；如果已经确定目标编码，再调用 getTargetFormats(targetEncoding, sourceFormat)，让实现列出可用的完整格式。

import java.util.Arrays;
import javax.sound.sampled.AudioFormat;
import javax.sound.sampled.AudioSystem;

static AudioFormat chooseTarget(AudioFormat source,
                                AudioFormat.Encoding desiredEncoding) {
    // 先展开完整候选，避免凭经验拼出一个可能不存在的格式。
    AudioFormat[] candidates = AudioSystem.getTargetFormats(desiredEncoding, source);
    if (candidates.length == 0) {
        // 空数组表示当前安装的转换器没有给出该编码的完整格式。
        return null;
    }
    // 这里的选择策略应由业务决定，示例暂取第一个候选。
    return candidates[0];
}

static String[] listEncodings(AudioFormat source) {
    // 返回的是实现报告的编码集合，不是文件扩展名列表。
    return Arrays.stream(AudioSystem.getTargetEncodings(source))
            .map(AudioFormat.Encoding::toString)
            .toArray(String[]::new);
}

候选数组的顺序不应被当成“质量从高到低”的排名。生产代码可以按采样率、声道数和业务容忍度筛选；筛选后仍建议再次调用完整格式的 isConversionSupported，把最终选择记录下来。

读取文件后，别把转换能力和写文件能力混在一起

从文件开始时，先让 getAudioInputStream 识别输入，再取得 sourceFormat。然后依次判断流格式转换和目标文件类型。输入可能无法识别，目标类型也可能没有写出 provider；这两类失败的处理方式不同。

import java.io.File;
import java.io.IOException;
import javax.sound.sampled.AudioFileFormat;
import javax.sound.sampled.AudioFormat;
import javax.sound.sampled.AudioInputStream;
import javax.sound.sampled.AudioSystem;
import javax.sound.sampled.UnsupportedAudioFileException;

static boolean canPrepare(File input,
                          AudioFormat targetFormat,
                          AudioFileFormat.Type outputType)
        throws IOException, UnsupportedAudioFileException {
    try (AudioInputStream source = AudioSystem.getAudioInputStream(input)) {
        AudioFormat sourceFormat = source.getFormat();
        // 先确认流格式转换这一层，避免直接创建不支持的转换流。
        if (!AudioSystem.isConversionSupported(targetFormat, sourceFormat)) {
            return false;
        }
        // 这里的 outputType 是文件容器类型，和 targetFormat 不是同一个概念。
        try (AudioInputStream converted =
                     AudioSystem.getAudioInputStream(targetFormat, source)) {
            // 判断的是“该转换后流能否写成目标容器”。
            return AudioSystem.isFileTypeSupported(outputType, converted);
        }
    }
}

示例只返回是否可以继续，并没有把输出文件写出去。真正写出时还应捕获 IllegalArgumentException、IOException 等执行异常，并采用临时文件或明确的覆盖策略；不能把“预查询为真”当成磁盘写入已经成功。

几个容易误判的边界

• 扩展名不等于格式。 文件名只能提供线索，输入格式应由 Java Sound 解析结果决定。
• 编码支持不等于完整格式支持。 目标编码可达时，指定的采样率、位深和声道仍可能没有对应候选。
• 转换支持不等于写出支持。 isFileTypeSupported 解决的是容器写出问题，不能替代 isConversionSupported。
• 预查询不是锁。 provider、输入内容和资源状态变化都可能让后续执行失败，所以要保留异常处理和资源关闭。

常见问题

只想判断“能不能转成某种编码”，该用哪个方法？ 使用 isConversionSupported(AudioFormat.Encoding, AudioFormat)；如果还要限制采样率、位深和声道，则构造目标 AudioFormat，使用完整格式重载。

getTargetFormats 返回空数组怎么办？ 把它视为当前安装转换器没有报告可用的完整目标格式，换一个目标组合或明确提示用户，不要直接取下标0。

为什么判断通过，实际 getAudioInputStream 仍会失败？ 因为判断针对的是格式能力，实际调用还要面对输入流有效性、provider 实现和资源限制；两处都要保留异常边界。

总结一下：先用源 AudioFormat 把问题说完整，再按编码、完整格式和文件类型逐层查询。这样既能减少转换异常，也能让“不支持”到底发生在哪一层变得可解释。