Springboot中使用InputStreamResource返回文件时如何处理FileInputStream？

问题分析 #

原代码直接通过new FileInputStream(file)创建流并包装为InputStreamResource返回，核心疑问及问题点如下：

1. FileInputStream能否被GC可靠回收？ #

不能。GC仅会回收FileInputStream对象本身，但它对应的操作系统文件句柄属于本地系统资源，GC不会主动关闭这类资源。只有当对象的finalize()方法被触发时，才可能间接关闭文件句柄，但finalize()的执行时机完全由GC调度决定，无法保证及时性。在高并发场景下，大量未关闭的文件句柄会快速耗尽系统资源，引发Too many open files错误，存在明确的资源泄漏风险。

2. 显式关闭/try-with-resources为何报错？ #

使用try-with-resources或显式关闭流时，流会在代码块结束后立即被关闭，但此时Spring MVC还未开始向客户端写入响应，后续尝试读取已关闭的流自然会抛出java.io.IOException: Stream Closed异常。

解决方案 #

推荐使用Spring提供的FileSystemResource替代InputStreamResource，它会延迟打开文件流，且Spring MVC会在响应处理完成后自动负责关闭流，无需手动管理资源：

@GetMapping("/download")
public ResponseEntity<FileSystemResource> downloadFile() throws IOException {
    MediaType mediaType = MediaTypeUtils.getMediaTypeForFileName(this.servletContext, fileName);
    File file = new File(filePath);
    FileSystemResource resource = new FileSystemResource(file);

    return ResponseEntity.ok()
        .header(HttpHeaders.CONTENT_DISPOSITION, "attachment;filename=" + file.getName())
        .contentType(mediaType)
        .contentLength(file.length())
        .body(resource);
}

原理说明 #

• FileSystemResource实现了Spring的Resource接口，只有当Spring MVC需要读取资源写入响应时，才会调用其getInputStream()方法打开文件流，响应完成后会自动关闭该流。
• 相比直接传入已打开的FileInputStream，这种方式避免了提前占用文件句柄，也彻底解决了流被过早关闭的问题，从根源上规避了资源泄漏风险。

若因特殊场景必须使用InputStreamResource（比如处理非文件来源的输入流），可自定义流包装类确保响应完成后关闭流，或依赖Spring MVC的资源生命周期管理机制，但此场景下FileSystemResource仍是最优选择。

内容的提问来源于stack exchange，提问作者Akhouri Soumya Prakash