SpringBoot中实现多文件打包下载的两种方案

 更新时间:2025年09月08日 08:37:03   作者:IT界Tony哥  
在Spring Boot中实现多文件打包下载,一般是将多个文件压缩成一个ZIP文件再进行下载,以下是两种典型实现方案以及代码示例,需要的朋友可以参考下

在Spring Boot中实现多文件打包下载,主要通过将多个文件压缩为ZIP格式并返回给客户端。以下是两种典型实现方案:

​​一、本地文件打包下载​​

​​核心步骤​​

  1. ​接收文件列表参数​
    通过@RequestParam List<String> filenames接收前端传递的文件名列表。
  2. ​动态生成ZIP文件​
    使用ZipOutputStream将文件逐个写入内存流,避免生成物理文件。
  3. ​设置响应头​
    通过Content-Disposition指定文件名,Content-Type设置为application/zip

​​代码示例​​

@GetMapping("/download-multiple")
public ResponseEntity<byte[]> downloadMultipleFiles(@RequestParam List<String> filenames) {
    try (ByteArrayOutputStream baos = new ByteArrayOutputStream();
         ZipOutputStream zos = new ZipOutputStream(baos)) {
         
        for (String filename : filenames) {
            Path filePath = Paths.get("/path/to/files").resolve(filename).normalize();
            if (Files.exists(filePath)) {
                ZipEntry zipEntry = new ZipEntry(filename);
                zos.putNextEntry(zipEntry);
                Files.copy(filePath, zos);
                zos.closeEntry();
            }
        }
        zos.finish();

        HttpHeaders headers = new HttpHeaders();
        headers.add(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename="files.zip"");
        return ResponseEntity.ok().headers(headers).body(baos.toByteArray());
    } catch (IOException e) {
        return ResponseEntity.internalServerError().build();
    }
}

​关键点​​:

  • 使用try-with-resources自动关闭流,避免资源泄漏。
  • normalize()方法防止路径遍历攻击(如../../)。
  • 内存中生成ZIP,适合小文件场景。

​​二、云存储(MinIO)集成方案​​

若文件存储在云存储(如MinIO),需先获取文件流再压缩:

​​实现步骤​​

​配置MinIO客户端​
添加依赖并配置MinIO连接信息:

minio:
  url: http://localhost:9000
  accessKey: your-key
  secretKey: your-secret
  bucketName: your-bucket

​动态压缩云存储文件​
从MinIO获取文件流,直接写入ZIP输出流:

@Autowired
private MinioClient minioClient;

@GetMapping("/download-zip")
public void downloadZip(@RequestParam List<String> fileNames, HttpServletResponse response) {
    response.setContentType("application/zip");
    response.setHeader("Content-Disposition", "attachment; filename=download.zip");
    
    try (ZipOutputStream zos = new ZipOutputStream(response.getOutputStream())) {
        for (String fileName : fileNames) {
            try (InputStream inputStream = minioClient.getObject(
                    GetObjectArgs.builder().bucket(bucketName).object(fileName).build())) {
                ZipEntry zipEntry = new ZipEntry(fileName);
                zos.putNextEntry(zipEntry);
                IOUtils.copy(inputStream, zos);
                zos.closeEntry();
            }
        }
    } catch (Exception e) {
        throw new RuntimeException("下载失败", e);
    }
}

​优化点​​:

  • 直接流式传输,避免内存溢出。
  • 支持断点续传(需结合HTTP Range请求)。

​​三、注意事项​​

  1. ​内存管理​
    大文件建议使用流式压缩(如ZipOutputStream),避免OutOfMemoryError
  2. ​路径安全​
    使用normalize()过滤非法路径,防止路径遍历攻击。
  3. ​异常处理​
    捕获IOException并返回明确错误状态码(如404文件不存在)。
  4. ​扩展性​
    可结合分片下载(Range请求)支持大文件断点续传。

​​四、前端调用示例​​

// 使用Fetch API触发下载
fetch(`/download-multiple?filenames=file1.txt,file2.jpg`, {
    method: 'GET'
}).then(response => {
    const blob = new Blob([response.blob()]);
    const link = document.createElement('a');
    link.href = URL.createObjectURL(blob);
    link.download = 'files.zip';
    link.click();
});

通过上述方案,可灵活实现本地或云存储的多文件打包下载,根据实际需求选择内存或流式处理。

到此这篇关于SpringBoot中实现多文件打包下载的两种方案的文章就介绍到这了,更多相关SpringBoot多文件打包下载内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • SpringBoot使用Validator进行参数校验实战教程(自定义校验,分组校验)

    SpringBoot使用Validator进行参数校验实战教程(自定义校验,分组校验)

    这篇文章主要介绍了SpringBoot使用Validator进行参数校验(自定义校验,分组校验)的实战教程,本文通过示例代码给大家介绍的非常详细,需要的朋友参考下吧
    2023-07-07
  • Idea+maven搭建SSH(struts2+hibernate5+spring5)环境的方法步骤

    Idea+maven搭建SSH(struts2+hibernate5+spring5)环境的方法步骤

    这篇文章主要介绍了Idea+maven搭建SSH(struts2+hibernate5+spring5)环境的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-06-06
  • SpringBoot集成SwaggerUi以及启动时遇到的错误

    SpringBoot集成SwaggerUi以及启动时遇到的错误

    这篇文章主要介绍了SpringBoot集成SwaggerUi以及启动时遇到的错误,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-06-06
  • 多个java泛型示例分享

    多个java泛型示例分享

    这篇文章主要介绍了多个java泛型示例,需要的朋友可以参考下
    2014-04-04
  • Flink实战之实现流式数据去重

    Flink实战之实现流式数据去重

    流式数据是一种源源不断产生的数据,本文探索了一种流式大数据的实时去重方法,不一定适用于所有场景,不过或许可以给面对相似问题的你一点点启发,
    2025-03-03
  • JAVA springboot如何开启俩端口

    JAVA springboot如何开启俩端口

    这篇文章主要介绍了JAVA springboot如何开启俩端口问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-03-03
  • Maven排除依赖和可选依赖的使用方法

    Maven排除依赖和可选依赖的使用方法

    我们知道Maven依赖具有传递性,例如A依赖于B,B依赖于C,在不考虑依赖范围等因素的情况下,Maven会根据依赖传递机制,将间接依赖C 引入到A中,但如果A出于某种原因,希望将间接依赖C排除,那该怎么办呢,Maven为用户提供了两种解决方式排出和可选
    2023-06-06
  • Java Request获取请求头数据实例详解

    Java Request获取请求头数据实例详解

    在开发中我们经常需要获取用户IP地址,通过地址来实现一些功能,下面这篇文章主要给大家介绍了关于Java中Request获取请求头数据的相关资料,需要的朋友可以参考下
    2024-01-01
  • java的接口解耦方式

    java的接口解耦方式

    这篇文章主要介绍了java的接口解耦方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-09-09
  • 详解Java如何优雅的使用装饰器模式

    详解Java如何优雅的使用装饰器模式

    装饰器设计模式大家肯定都听说过,但是有没有使用过呢,今天本君就跟大家分享一下装饰器模式应该如何使用,感兴趣的小伙伴可以学习一下
    2022-09-09

最新评论