Spring Boot中实现多文件打包下载

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


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

​核心步骤​

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

​代码示例​

scss 复制代码
@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),需先获取文件流再压缩:

​实现步骤​

  1. ​配置MinIO客户端​

    添加依赖并配置MinIO连接信息:

    yaml 复制代码
    minio:
      url: http://localhost:9000
      accessKey: your-key
      secretKey: your-secret
      bucketName: your-bucket
  2. ​动态压缩云存储文件​

    从MinIO获取文件流,直接写入ZIP输出流:

    less 复制代码
    @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请求)支持大文件断点续传。

​四、前端调用示例​

ini 复制代码
// 使用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();
});

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

相关推荐
李昊哲小课1 分钟前
Spring Boot 基础教程
java·大数据·spring boot·后端
码事漫谈11 分钟前
C++内存越界的幽灵:为什么代码运行正常,free时却崩溃了?
后端
Swift社区20 分钟前
Spring Boot 3.x + Security + OpenFeign:如何避免内部服务调用被重复拦截?
java·spring boot·后端
90后的晨仔20 分钟前
Mac 上配置多个 Gitee 账号的完整教程
前端·后端
码事漫谈21 分钟前
AI智能体平台选型指南:从技术架构到商业落地的全景洞察
后端
龙茶清欢1 小时前
4、除了常见的 services(业务微服务)和 gateway(API 网关)模块外,还必须建立一系列支撑性、平台级、基础设施类模块
微服务·架构·gateway
Q_Q19632884751 小时前
python+uniapp基于微信小程序的医院陪诊预约系统
开发语言·spring boot·python·微信小程序·django·flask·uni-app
武昌库里写JAVA1 小时前
SpringCloud与微服务
vue.js·spring boot·sql·layui·课程设计
青柠编程1 小时前
基于 Spring Boot 的医疗病历信息交互平台架构设计
java·spring boot·后端
疯癫的老码农2 小时前
【word解析】Java文件解析问题排查:无法找到OMML2MML.xsl的IO异常解析
java·开发语言·spring boot·spring·maven