利用Hutool的ZipUtil实现多文件动态打包与浏览器端一键下载

最新推荐文章于 2026-03-08 07:51:40 发布

原创

最新推荐文章于 2026-03-08 07:51:40 发布 · 175 阅读

标签

#Hutool #ZipUtil #文件打包 #Java Web开发

1. 为什么你需要Hutool的ZipUtil？

做Web开发的朋友，尤其是经常处理文件导出、报表生成这类需求的，肯定都遇到过这个头疼的场景：用户需要一次性下载多个文件。比如，一个项目详情页，用户想导出数据，结果发现数据分散在Word报告、Excel明细表、还有一堆图片和PDF附件里。你总不能让用户一个个去点下载吧？那体验太差了。用户想要的，往往就是一个“打包带走”的按钮，点一下，所有相关文件自动打成一个整齐的ZIP包，嗖的一下就开始下载了。

我以前就踩过这个坑。最早的做法很原始：服务器端先用java.util.zip吭哧吭哧写一堆流操作的代码，处理各种ZipEntry，还得小心文件路径和中文乱码问题。然后前端触发下载，又要处理HttpServletResponse，设置一堆Header，像Content-Type、Content-Disposition，还得记得关流、删临时文件。一套流程写下来，代码又长又容易出错，哪天不小心内存泄露了或者临时文件没删干净，服务器磁盘就被塞满了。

直到我发现了Hutool这个国产的“神器”工具包，尤其是里面的ZipUtil。它简直是把上面那一整套复杂操作，封装成了“一句话”的事。你不需要再关心底层的压缩算法、流怎么对接、临时文件怎么管理，ZipUtil都给你处理得明明白白。它的核心价值，就是让“动态打包”和“浏览器一键下载”这两个动作，变得像调用一个普通工具方法一样简单。所谓动态打包，就是根据用户的请求，实时地从数据库、文件服务器或者内存中收集文件，在内存或临时目录快速压缩，不落盘或者落盘后自动清理。而浏览器一键下载，就是通过正确的HTTP响应，让浏览器自动识别这是一个需要下载的ZIP文件，并弹出保存对话框。

所以，如果你正在为以下场景发愁，那这篇文章就是为你准备的：OA系统的报表批量导出、电商平台的后台数据打包、内容管理系统的资料归档、或者任何需要让用户方便地下载多个文件的Web应用。接下来，我就手把手带你，用ZipUtil把这件事优雅地搞定。

2. 5分钟快速上手：你的第一个ZIP打包下载

光说不练假把式，咱们直接上代码，让你在5分钟内看到效果。首先，你得把Hutool引入到你的项目里。如果你用的是Maven，在pom.xml里加上这个依赖就行，记得选个新点的版本，功能更全。

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.16</version> <!-- 请使用最新稳定版 -->
</dependency>

引入之后，我们来写一个最简单的Controller方法。假设我们有两个静态文件放在服务器的D:\export目录下，现在要打包让用户下载。

import cn.hutool.core.io.FileUtil;
import cn.hutool.core.util.ZipUtil;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.IOException;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.List;

@RestController
public class DownloadController {

    @GetMapping("/downloadSimpleZip")
    public void downloadSimpleZip(HttpServletResponse response) throws IOException {
        // 1. 准备要打包的文件列表
        List<File> fileList = new ArrayList<>();
        fileList.add(new File("D:\\export\\月度报告.docx"));
        fileList.add(new File("D:\\export\\销售数据.xlsx"));
        fileList.add(new File("D:\\export\\示意图.png"));

        // 2. 指定临时ZIP文件的生成路径（也可以不指定，用下面更简单的方法）
        File zipFile = new File("D:\\temp\\export_package.zip");

        // 3. 使用ZipUtil打包文件
        // 参数说明：zipFile-目标zip文件， false-不保留原目录结构（文件直接放在zip根目录）， fileList-文件列表
        ZipUtil.zip(zipFile, false, fileList.toArray(new File[0]));

        // 4. 设置HTTP响应头，告诉浏览器这是一个需要下载的ZIP文件
        response.setContentType("application/octet-stream");
        response.setHeader("Content-Disposition",
                "attachment;filename=" + URLEncoder.encode("我的压缩包.zip", StandardCharsets.UTF_8.name()));

        // 5. 将ZIP文件写入响应流
        FileUtil.writeToStream(zipFile, response.getOutputStream());

        // 6. 【重要】删除临时生成的ZIP文件，避免堆积占用磁盘空间
        FileUtil.del(zipFile);
    }
}

启动你的Spring Boot应用，浏览器访问 http://localhost:8080/downloadSimpleZip，你会发现浏览器立刻就开始下载一个名为“我的压缩包.zip”的文件，解压后里面正是我们指定的三个文件。

怎么样？是不是比想象中简单？核心就两步：ZipUtil.zip()打包，然后设置响应头并输出流。但是，这个