Java文件下载时始终识别为application/octet-stream的问题排查

你当前的文件下载实现代码如下：

@GetMapping("/downloadFile/")
public ResponseEntity<Resource> downloadFile(@RequestParam String fileName, HttpServletRequest request) {
    // Load file as Resource
    Resource resource = fileStorageService.loadOneFileAsResource(fileName);

    // Try to determine file's content type
    String contentType = null;
    try {
        contentType = request.getServletContext().getMimeType(resource.getFile().getAbsolutePath());
    } catch (IOException ex) {
        logger.info("Could not determine file type.");
    }

    // Fallback to the default content type if type could not be determined
    if(contentType == null) {
        contentType = "application/octet-stream";
    }

    return ResponseEntity.ok()
            .contentType(MediaType.parseMediaType(contentType))
            .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + resource.getFilename() + "\"")
            .body(resource);
}

问题原因分析 #

• ServletContext.getMimeType依赖容器配置：该方法依赖Web容器（如Tomcat）自带的MIME类型映射表，仅支持常见文件格式，小众格式或自定义扩展名的文件会识别失败，直接返回null。
• Resource.getFile()存在兼容性问题：如果你的Resource是Jar包内资源、网络资源等非本地文件系统资源，getFile()会抛出IOException，进入catch块后contentType保持null，最终触发默认值。
• 文件名扩展名异常：文件名缺少扩展名、扩展名被篡改或包含特殊字符，会导致ServletContext无法正确解析格式。

解决方案 #

方案一：使用Spring MediaTypeFactory（推荐） #

Spring提供了独立于容器的MediaType探测工具，覆盖更全面的MIME类型，支持从文件名或输入流探测：

// 从文件名探测
try {
    contentType = MediaTypeFactory.getMediaType(resource.getFilename()).orElse(null);
} catch (Exception ex) {
    logger.info("Could not determine file type.");
}

// 或者结合输入流探测（更准确，适合无扩展名或扩展名错误的文件）
try (InputStream is = resource.getInputStream()) {
    contentType = MediaTypeFactory.getMediaType(is).orElse(null);
} catch (IOException ex) {
    logger.info("Could not determine file type.");
}

方案二：使用Java NIO Files.probeContentType #

依赖系统文件类型探测服务，准确性高，但仅支持本地文件系统资源：

try {
    Path filePath = Paths.get(resource.getURI());
    contentType = Files.probeContentType(filePath);
} catch (IOException ex) {
    logger.info("Could not determine file type.");
}

注意：Jar内资源无法用此方法，会抛出异常。

方案三：手动维护自定义MIME映射 #

针对自定义扩展名的文件，自行维护映射表：

// 自定义MIME映射
private static final Map<String, String> CUSTOM_MIME_MAP = new HashMap<>();
static {
    CUSTOM_MIME_MAP.put(".xyz", "application/custom-xyz");
    CUSTOM_MIME_MAP.put(".md", "text/markdown");
    // 添加更多自定义格式
}

// 探测逻辑
String fileName = resource.getFilename();
String extension = fileName.substring(fileName.lastIndexOf(".")).toLowerCase();
contentType = CUSTOM_MIME_MAP.get(extension);
if (contentType == null) {
    //  fallback到MediaTypeFactory
    contentType = MediaTypeFactory.getMediaType(fileName).orElse("application/octet-stream");
}

可以使用Apache Commons IO的FilenameUtils.getExtension()简化扩展名获取。

方案四：避免使用Resource.getFile() #

如果资源不是本地文件，不要调用getFile()，改用getInputStream()或getURI()处理，避免触发IOException导致探测失败。

内容的提问来源于stack exchange，提问作者amir raad