本文介绍如何在 spring boot 应用中接收上传的 zip 文件流，直接在内存中解压并处理各文件内容，全程不落盘，兼顾安全性与性能。
本文介绍如何在 spring boot 应用中接收上传的 zip 文件流，直接在内存中解压并处理各文件内容，全程不落盘，兼顾安全性与性能。
在微服务或文件处理类 Spring Boot 应用中，常需解析用户上传的 ZIP 压缩包（如配置集、资源包、批量数据），但出于安全合规或临时性处理需求，禁止将原始 ZIP 或其解压内容写入磁盘。此时应采用纯内存流式解压方案，依托 java.util.zip.ZipInputStream 配合 Spring 的 MultipartFile 或原始 InputStream 实现零落盘操作。
✅ 核心实现原理
ZIP 文件本质是按“条目（ZipEntry）+ 数据流”组织的复合结构。ZipInputStream 可从任意 InputStream（如 MultipartFile.getInputStream()）逐个读取 ZipEntry，并通过 readAllBytes() 或分块读取获取其字节内容，整个过程完全在 JVM 堆内存中完成，无需创建临时文件。
? 完整代码示例（Spring Boot Controller + Service）
@RestController
@RequestMapping("/api/unzip")
public class ZipStreamController {
@PostMapping(value = "/memory", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
public ResponseEntity<Map<String, String>> unzipInMemory(
@RequestParam("file") MultipartFile zipFile) throws IOException {
if (zipFile.isEmpty()) {
return ResponseEntity.badRequest().body(Map.of("error", "ZIP file is empty"));
}
try (InputStream inputStream = zipFile.getInputStream();
ZipInputStream zis = new ZipInputStream(inputStream)) {
Map<String, String> entryContents = new LinkedHashMap<>();
ZipEntry entry;
while ((entry = zis.getNextEntry()) != null) {
if (entry.isDirectory()) {
// 跳过目录项（ZIP 中可能包含空目录）
zis.closeEntry();
continue;
}
// ✅ 关键：内存读取，不写磁盘
byte[] content = zis.readAllBytes();
String fileName = entry.getName();
String textContent = new String(content, StandardCharsets.UTF_8);
entryContents.put(fileName, textContent);
zis.closeEntry();
}
return ResponseEntity.ok(Map.of(
"status", "success",
"entries", String.valueOf(entryContents.size()),
"files", entryContents.keySet().toString()
));
}
}
}? 提示：若 ZIP 内含大文件（如 >10MB），建议改用 zis.read(byte[], off, len) 分块读取，并结合 ByteArrayOutputStream 或直接流式处理（如解析 CSV/JSON），避免 readAllBytes() 导致 OOM。
⚠️ 注意事项与最佳实践
-
字符编码：ZIP 条目名及内容编码需明确（常见为 UTF-8），避免中文乱码；可使用 ZipInputStream 构造函数指定 Charset（Java 11+ 支持）：
new ZipInputStream(inputStream, StandardCharsets.UTF_8)
- 资源释放：务必使用 try-with-resources 确保 ZipInputStream 和底层 InputStream 正确关闭，防止连接/句柄泄漏。
-
安全过滤：解压前应校验 ZipEntry.getName()，拒绝路径遍历（如 ../etc/passwd）、绝对路径或非法控制字符，防范 ZIP Slip 漏洞：
String cleanName = FilenameUtils.normalize(entry.getName(), true); if (cleanName == null || cleanName.startsWith("../") || cleanName.contains("..")) { throw new IllegalArgumentException("Invalid ZIP entry path: " + entry.getName()); } - 异常处理：捕获 ZipException（损坏 ZIP）、IOException（流中断）等，并返回清晰错误码，便于前端重试或提示。
✅ 总结
通过 ZipInputStream 结合 Spring Boot 的 MultipartFile，可在不生成任何临时文件的前提下完成 ZIP 解压与内容提取。该方案轻量、安全、可控，适用于日志分析、配置加载、批量导入等场景。关键在于理解 ZIP 流式结构、严格资源管理、主动防御路径注入，并根据实际数据规模选择合适的内存读取策略。
