You need to enable JavaScript to run this app. 如何基于Minio对象路径生成带正确嵌套目录结构的Zip压缩包
优惠活动
大模型
产品
解决方案
定价
更多

如何基于Minio对象路径生成带正确嵌套目录结构的Zip压缩包

Minio路径生成带嵌套结构Zip压缩包解决方案

原代码仅支持单个文件的压缩下载,传入路径前缀(虚拟目录)时出现异常的核心原因有两个:

  1. Minio中的目录是虚拟路径标识,不是实际存储的对象,直接调用getObject方法获取目录路径会抛出资源不存在异常
  2. 没有递归遍历路径前缀下的所有子对象,无法生成嵌套目录结构

实现逻辑

  • 调用Minio的listObjects接口,遍历指定bucket下匹配传入路径前缀的所有对象,开启递归查询获取子目录下的全部文件
  • 过滤虚拟目录对象(需要保留空目录可跳过该步)
  • 为每个文件对象创建对应的ZipEntry,直接使用对象的完整路径作为ZipEntry的路径,Zip输出流会自动根据路径中的斜杠生成嵌套目录结构,无需手动创建目录条目
  • 将每个对象的输入流写入Zip输出流,完成条目写入后关闭当前条目

修改后完整代码

import io.minio.ListObjectsArgs;
import io.minio.Result;
import io.minio.messages.Item;
import org.springframework.util.StreamUtils;
import javax.servlet.http.HttpServletResponse;
import java.io.InputStream;
import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream;

private void zip(HttpServletResponse response, String bucket, String path) {
    // 提前设置响应头,避免压缩包文件名乱码
    response.setContentType("application/zip");
    response.setHeader("Content-Disposition", "attachment;filename=download.zip");
    
    try (ZipOutputStream zos = new ZipOutputStream(response.getOutputStream())) {
        // 递归遍历指定前缀下的所有对象
        Iterable<Result<Item>> results = minioClient.listObjects(
            ListObjectsArgs.builder()
                .bucket(bucket)
                .prefix(path)
                .recursive(true)
                .build()
        );

        for (Result<Item> result : results) {
            Item item = result.get();
            // 跳过虚拟目录对象,不需要单独写入目录条目
            if (item.isDir()) {
                continue;
            }
            String objectName = item.objectName();
            // 如果需要压缩包根目录去掉公共前缀,可替换为下面两行代码
            // String entryPath = objectName.replaceFirst(path, "");
            // ZipEntry zipEntry = new ZipEntry(entryPath);
            ZipEntry zipEntry = new ZipEntry(objectName);
            zos.putNextEntry(zipEntry);
            // 读取Minio对象写入压缩包
            try (InputStream is = getObjectFromMinio(bucket, objectName)) {
                StreamUtils.copy(is, zos);
            }
            zos.closeEntry();
        }
    } catch (Exception e) {
        // 自定义异常处理逻辑
        e.printStackTrace();
    }
}

补充说明

  • 如果需要保留空目录,可在过滤到目录类型的Item时,创建以斜杠结尾的ZipEntry写入即可,示例:zos.putNextEntry(new ZipEntry(item.objectName())); zos.closeEntry();
  • 生成压缩包的层级完全由ZipEntry的路径决定,路径中包含的/会被自动识别为目录分隔符,自动生成对应的嵌套文件夹结构

内容的提问来源于stack exchange,提问作者Forin

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.17 04:24:05