SpringBoot下载MongoDB GridFS多文件为ZIP报错的解决方案

你遇到的GridFS resource can not be resolved to an absolute file path报错，核心原因是GridFS存储的文件以二进制块的形式保存在MongoDB中，不存在服务器本地文件系统对应的实体文件，因此无法通过getFile()方法获取可被FileSystemResource解析的本地File对象。基于FileSystemResource的多文件打包方案仅适用于文件存放在服务器本地磁盘的场景，完全不适配GridFS存储源。

不需要将GridFS文件转存到服务器本地生成临时文件，直接基于流操作将GridFS中的文件写入ZIP输出流，全程在内存中完成打包，既可以避免额外磁盘IO开销，也不需要处理临时文件清理、并发文件重名等问题。

• 基础依赖确认：确保项目已经正常引入Spring Boot Web、Spring Data MongoDB依赖，打包逻辑直接使用JDK自带的java.util.zip.ZipOutputStream实现，不需要额外引入第三方ZIP工具包。
• 接口实现逻辑：设置好下载响应头后，逐个读取GridFS文件的输入流，写入ZIP条目，最终将ZIP流直接写入响应输出流返回给前端。

核心实现代码参考：

import org.springframework.data.mongodb.gridfs.GridFsResource;
import org.springframework.data.mongodb.gridfs.GridFsTemplate;
import org.springframework.http.HttpHeaders;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.InputStream;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.List;
import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream;

@RestController
public class FileDownloadController {

    private final GridFsTemplate gridFsTemplate;

    public FileDownloadController(GridFsTemplate gridFsTemplate) {
        this.gridFsTemplate = gridFsTemplate;
    }

    @GetMapping("/download/files-zip")
    public void downloadFilesAsZip(@RequestParam List<String> fileIds, HttpServletResponse response) throws IOException {
        // 设置下载响应头，处理中文文件名乱码
        response.setContentType(MediaType.APPLICATION_OCTET_STREAM_VALUE);
        String zipName = URLEncoder.encode("业务文件打包.zip", StandardCharsets.UTF_8);
        response.setHeader(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename*=UTF-8''" + zipName);

        try (ZipOutputStream zos = new ZipOutputStream(response.getOutputStream())) {
            byte[] buffer = new byte[8192];
            for (String fileId : fileIds) {
                GridFsResource gridFsResource = gridFsTemplate.getResource(fileId);
                // 跳过不存在的文件，可根据业务需求调整为抛出异常
                if (!gridFsResource.exists()) {
                    continue;
                }
                // 创建ZIP包内的文件条目，使用GridFS中存储的原始文件名
                ZipEntry zipEntry = new ZipEntry(gridFsResource.getFilename());
                zos.putNextEntry(zipEntry);

                // 流拷贝：直接将GridFS文件流写入ZIP输出流，不落地本地磁盘
                try (InputStream is = gridFsResource.getInputStream()) {
                    int len;
                    while ((len = is.read(buffer)) > 0) {
                        zos.write(buffer, 0, len);
                    }
                }
                zos.closeEntry();
            }
            zos.finish();
        }
    }
}

• 如果打包的文件存在重名可能，创建ZipEntry时可以给文件名增加序号/业务标识前缀，避免ZIP包内文件互相覆盖。
• 如果单次打包的文件总大小较大，可以适当调大缓冲区字节数，优化传输效率；如果能提前统计所有待打包文件的总大小，可以在响应头中提前设置Content-Length，方便前端展示准确的下载进度。
• 文件名响应头必须按照示例中filename*=UTF-8''的格式设置，否则部分浏览器会出现中文文件名乱码问题。
• 所有流对象统一用try-with-resources语法包裹，自动释放资源，避免出现流泄漏问题。

内容的提问来源于stack exchange，提问作者Bifrost