Java Files.probeContentType 怎样判断文件的 MIME 类型

Java 中判断一个路径对应的文件类型，可以先调用 Files.probeContentType(Path)。它会尝试返回 MIME 类型字符串，例如 text/plain；如果当前环境无法判断，则返回 null，遇到 I/O 问题则抛出 IOException。最重要的一点是：这个方法适合做类型提示和分流，不等于对文件内容做安全鉴定。

官方地址：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/nio/file/Files.html#probeContentType(java.nio.file.Path)

先记住三个返回分支

最小写法：Path、扩展名与返回值

调用入口只有一个 Path 参数。下面的写法把“识别成功”“无法识别”和“访问失败”拆成三个互不混淆的分支：

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;

public class ContentTypeProbe {
    public static void main(String[] args) {
        Path path = Path.of("report.pdf");

        try {
            String mime = Files.probeContentType(path);
            if (mime == null) {
                // null 表示当前探测能力没有给出类型，不代表文件一定无效。
                System.out.println("无法确定 MIME 类型");
                return;
            }

            // MIME 值只用于类型分流，后续仍要按业务读取或校验文件。
            System.out.println("MIME 类型：" + mime);
        } catch (IOException e) {
            // I/O 错误与“无法识别”不同，保留原异常便于定位路径或权限问题。
            System.err.println("探测文件类型失败：" + e.getMessage());
        }
    }
}

不要只写成 if (mime.startsWith("image/")) 而没有处理 null。探测不到时直接调用字符串方法，会把一个可预期的未知类型变成 NullPointerException。

探测依据不是“只看文件内容”

Java API 会依次调用已经安装的 FileTypeDetector 实现；如果这些探测器都没有识别结果，再调用系统默认的文件类型探测器猜测。探测器由服务提供者机制加载，加载顺序由具体实现决定，因此同一个路径在不同操作系统、文件系统提供者或运行环境中，结果可能不同。

实践中常见的结果是：report.pdf 这类带有明确扩展名的路径容易得到类型，而自定义后缀、无后缀文件或能力不完整的文件系统可能得到 null。这不是 Java 代码写错，而是探测能力的边界。

返回 null 时怎么判断

null 的准确含义是“当前方法无法确定内容类型”，不是“文件一定不存在”，也不是“文件一定不安全”。可以把它接入一个清晰的兜底策略：

static String classify(Path path) throws IOException {
    String mime = Files.probeContentType(path);

    if (mime == null) {
        // 未知类型时不要擅自猜测，交给明确的业务兜底策略。
        return "unknown";
    }
    if (mime.equals("application/pdf")) {
        // 只按已识别的类型做分流，真正读取前仍需要业务校验。
        return "pdf";
    }

    // 其他 MIME 类型保留原值，避免丢失探测器提供的信息。
    return mime;
}

如果业务要求只接收 PDF，可以把未知类型和非 PDF 类型分别记录；如果业务允许继续处理，则把 null 交给后续解析器或人工确认。关键是不要把未知值静默映射成一个看似合理的类型。

不要把 MIME 探测当成安全校验

probeContentType 的职责是“尽力探测类型”。它返回一个 MIME 字符串，不会替你确认文件内容是否符合格式，也不会替你完成恶意内容检测、解码容错检查或上传安全策略。

如果这是上传入口，比较稳妥的分层方式是：先限制大小和路径，再把探测结果当作提示；真正接收后使用对应解析器读取文件头和结构，必要时执行独立的安全扫描；最终保存时不要直接信任用户提供的文件名和扩展名。

迁移清单：把“猜扩展名”改成“可解释分支”

1. 把文件路径统一转换成与目标文件系统关联的 Path。
2. 用 Files.probeContentType(path) 获取环境提供的 MIME 提示。
3. 显式处理 null，不要让它流入字符串方法或默认白名单。
4. 单独捕获 IOException，区分访问失败和未知类型。
5. 把 MIME 探测、内容解析和安全扫描拆开，避免把一个辅助 API 当成完整校验方案。

常见问题

为什么同一个扩展名在不同机器上结果不同？

因为探测器由运行环境和文件系统提供者决定，系统默认映射也可能不同。文章中的返回值是环境能力的结果，不是跨平台固定字典。

返回 null 是否说明 Path 不存在？

不能这样推断。null 表示类型无法确定；如果要判断存在性，应使用专门的文件系统 API，并仍然处理竞态和权限问题。

拿到 image/png 就能安全打开图片吗？

不能。MIME 值只适合做分流提示，打开或保存前仍应使用对应解析器和独立安全策略核对内容。

总结

Files.probeContentType(Path) 的正确用法可以概括为：成功时使用 MIME 字符串分流，null 时进入明确的未知类型策略，IOException 时按 I/O 失败处理；同时记住探测结果依赖 Provider，不能替代内容解析和安全校验。