SpringBoot中實現(xiàn)多文件打包下載的兩種方案

更新時間：2025年09月08日 08:37:03 作者：IT界Tony哥

在Spring Boot中實現(xiàn)多文件打包下載,一般是將多個文件壓縮成一個ZIP文件再進行下載,以下是兩種典型實現(xiàn)方案以及代碼示例,需要的朋友可以參考下

??一、本地文件打包下載??

??核心步驟??

??接收文件列表參數(shù)??
通過@RequestParam List<String> filenames接收前端傳遞的文件名列表。
??動態(tài)生成ZIP文件??
使用ZipOutputStream將文件逐個寫入內(nèi)存流，避免生成物理文件。
??設(shè)置響應(yīng)頭??
通過Content-Disposition指定文件名，Content-Type設(shè)置為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();
    }
}

??關(guān)鍵點??：

使用try-with-resources自動關(guān)閉流，避免資源泄漏。
normalize()方法防止路徑遍歷攻擊（如../../）。
內(nèi)存中生成ZIP，適合小文件場景。

??二、云存儲（MinIO）集成方案??

若文件存儲在云存儲（如MinIO），需先獲取文件流再壓縮：

??實現(xiàn)步驟??

??配置MinIO客戶端??
添加依賴并配置MinIO連接信息：

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

??動態(tài)壓縮云存儲文件??
從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);
    }
}

??優(yōu)化點??：

直接流式傳輸，避免內(nèi)存溢出。
支持?jǐn)帱c續(xù)傳（需結(jié)合HTTP Range請求）。

??三、注意事項??

??內(nèi)存管理??
大文件建議使用流式壓縮（如ZipOutputStream），避免OutOfMemoryError。
??路徑安全??
使用normalize()過濾非法路徑，防止路徑遍歷攻擊。
??異常處理??
捕獲IOException并返回明確錯誤狀態(tài)碼（如404文件不存在）。
??擴展性??
可結(jié)合分片下載（Range請求）支持大文件斷點續(xù)傳。

??四、前端調(diào)用示例??

// 使用Fetch API觸發(fā)下載
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();
});

通過上述方案，可靈活實現(xiàn)本地或云存儲的多文件打包下載，根據(jù)實際需求選擇內(nèi)存或流式處理。

到此這篇關(guān)于SpringBoot中實現(xiàn)多文件打包下載的兩種方案的文章就介紹到這了,更多相關(guān)SpringBoot多文件打包下載內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: