\u9700\u8981\u5c06\u4e00\u6279\u6587\u4ef6\uff08\u53ef\u80fd\u5206\u5e03\u5728\u4e0d\u540c\u76ee\u5f55\u3001\u4e0d\u540c\u6765\u6e90\uff09\u6253\u5305\u6210Zip\u683c\u5f0f\uff0c\u6309\u76ee\u5f55\u7ed3\u6784\u5bfc\u51fa\u7ed9\u7528\u6237\u4e0b\u8f7d\u3002<\/p>\n\n\n\n
\/data\/upload\/xxx.jpg<\/code>\uff09\u6253\u5305\u8fdbZip\uff0c\u4fdd\u6301\u539f\u6709\u76ee\u5f55\u7ed3\u6784\u3002<\/li>\n\n\n\n- \u2022 \u652f\u6301\u901a\u8fc7HTTP\u4e0b\u8f7d\u8fdc\u7a0b\u6587\u4ef6\u5199\u5165Zip\u3002<\/li>\n\n\n\n
- \u2022 \u6240\u6709\u5199\u5165Zip\u7684\u76ee\u5f55\u540d\u3001\u6587\u4ef6\u540d\u5747\u9700\u5b89\u5168\u5904\u7406\u3002<\/li>\n\n\n\n
- \u2022 \u7edf\u4e00\u4f7f\u7528\u6d41\u5f0fIO\uff0c\u9002\u5408\u5927\u6587\u4ef6\/\u5927\u91cf\u6587\u4ef6\u5bfc\u51fa\uff0c\u9632\u6b62\u5185\u5b58\u6ea2\u51fa\u3002<\/li>\n\n\n\n
- \u2022 \u76ee\u5f55\u4e0b\u65e0\u6587\u4ef6\u65f6\u5199\u5165
empty.txt<\/code>\u6807\u8bc6\u3002<\/li>\n<\/ul>\n\n\n\n2. \u4ee3\u7801\u5b9e\u73b0<\/h3>\n\n\n\n2.1 \u5de5\u5177\u7c7b\uff1a\u672c\u5730&HTTP\u4e24\u79cd\u65b9\u5f0f\u5199\u5165Zip<\/h4>\n\n\n\npackage com.example.xiaoshitou.utils;
import org.apache.commons.compress.archivers.zip.ZipArchiveEntry;
import org.apache.commons.compress.archivers.zip.ZipArchiveOutputStream;
import org.springframework.util.StreamUtils;
import org.springframework.util.StringUtils;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.*;
import java.net.URL;
import java.net.URLConnection;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.time.LocalDate;
\/***
* @title
* @author shijiangyong
* @date 2025\/4\/28 16:34
**\/
public class ZipDownloadUtils {
private static final String<\/em> SUFFIX_ZIP = \".zip\";
private static final String<\/em> UNNAMED = \"\u672a\u547d\u540d\";
\/**
* \u5b89\u5168\u5904\u7406\u6587\u4ef6\u540d\/\u76ee\u5f55\u540d
* @param name
* @return
*\/
public static String safeName(String name) {
if (name == null) return \"null\";
return name.replaceAll(\"[\\\\\\\\\/:*?\\\"<>|]\", \"_\");
}
\/**
* HTTP\u4e0b\u8f7d\u5199\u5165Zip
* @param zipOut
* @param fileUrl
* @param zipEntryName
* @throws IOException
*\/
public static void writeHttpFileToZip(ZipArchiveOutputStream zipOut, String fileUrl, String zipEntryName) throws IOException {
ZipArchiveEntry<\/em> entry = new ZipArchiveEntry(zipEntryName);
zipOut.putArchiveEntry(entry);
try (InputStream<\/em> in = openHttpStream(fileUrl, 8000, 20000)) {
byte<\/em>[] buffer = new byte[4096];
int<\/em> len;
while ((len = in.read(buffer)) != -1) {
zipOut.write(buffer, 0, len);
}
} catch (Exception e) {
zipOut.write((\"\u4e0b\u8f7d\u5931\u8d25: \" + fileUrl).getBytes(StandardCharsets.UTF_8));
}
zipOut.closeArchiveEntry();
}
\/**
* \u672c\u5730\u6587\u4ef6\u5199\u5165Zip
* @param zipOut
* @param localFilePath
* @param zipEntryName
* @throws IOException
*\/
public static void writeLocalFileToZip(ZipArchiveOutputStream zipOut, String localFilePath, String zipEntryName) throws IOException {
File<\/em> file = new File(localFilePath);
if (!file.exists() || file.isDirectory()) {
writeTextToZip(zipOut, zipEntryName + \"_empty.txt\", \"\u6587\u4ef6\u4e0d\u5b58\u5728\u6216\u662f\u76ee\u5f55: \" + localFilePath);
return;
}
ZipArchiveEntry<\/em> entry = new ZipArchiveEntry(zipEntryName);
zipOut.putArchiveEntry(entry);
try (InputStream<\/em> fis = new FileInputStream(file)) {
byte<\/em>[] buffer = new byte[4096];
int<\/em> len;
while ((len = fis.read(buffer)) != -1) {
zipOut.write(buffer, 0, len);
}
}
zipOut.closeArchiveEntry();
}
\/**
* \u5199\u5165\u6587\u672c\u6587\u4ef6\u5230Zip\uff08\u5982empty.txt\uff09
* @param zipOut
* @param zipEntryName
* @param content
* @throws IOException
*\/
public static void writeTextToZip(ZipArchiveOutputStream zipOut, String zipEntryName, String content) throws IOException {
ZipArchiveEntry<\/em> entry = new ZipArchiveEntry(zipEntryName);
zipOut.putArchiveEntry(entry);
zipOut.write(content.getBytes(StandardCharsets.UTF_8));
zipOut.closeArchiveEntry();
}
\/**
* \u6253\u5f00HTTP\u6587\u4ef6\u6d41
* @param url
* @param connectTimeout
* @param readTimeout
* @return
* @throws IOException
*\/
public static InputStream openHttpStream(String url, int<\/em> connectTimeout, int<\/em> readTimeout) throws IOException {
URLConnection<\/em> conn = new URL(url).openConnection();
conn.setConnectTimeout(connectTimeout);
conn.setReadTimeout(readTimeout);
return conn.getInputStream();
}
\/**
* \u4eceurl\u83b7\u53d6\u6587\u4ef6\u540d
* @param url
* @return
* @throws IOException
*\/
public static String getFileName(String url) {
return url.substring(url.lastIndexOf('\/')+1);
}
\/**
* \u8bbe\u7f6eresponse
* @param request
* @param response
* @param fileName
* @throws UnsupportedEncodingException
*\/
public static void setResponse(HttpServletRequest request, HttpServletResponse response, String fileName) throws UnsupportedEncodingException {
if (!StringUtils.hasText(fileName)) {
fileName = LocalDate.now() + UNNAMED;
}
if (!fileName.endsWith(SUFFIX_ZIP)) {
fileName = fileName + SUFFIX_ZIP;
}
response.setHeader(\"Connection\", \"close\");
response.setHeader(\"Content-Type\", \"application\/octet-stream;charset=UTF-8\");
String<\/em> filename = encodeFileName(request, fileName);
response.setHeader(\"Content-Disposition\", \"attachment;filename=\" + filename);
}
\/**
* \u6587\u4ef6\u540d\u5728\u4e0d\u540c\u6d4f\u89c8\u5668\u517c\u5bb9\u5904\u7406
* @param request \u8bf7\u6c42\u4fe1\u606f
* @param fileName \u6587\u4ef6\u540d
* @return
* @throws UnsupportedEncodingException
*\/
public static String encodeFileName(HttpServletRequest request, String fileName) throws UnsupportedEncodingException {
String<\/em> userAgent = request.getHeader(\"USER-AGENT\");
\/\/ \u706b\u72d0\u6d4f\u89c8\u5668
if (userAgent.contains(\"Firefox\") || userAgent.contains(\"firefox\")) {
fileName = new String(fileName.getBytes(), \"ISO8859-1\");
} else {
\/\/ \u5176\u4ed6\u6d4f\u89c8\u5668
fileName = URLEncoder.encode(fileName, \"UTF-8\");
}
return fileName;
}
}<\/code><\/pre>\n\n\n\n2.2 Controller \u793a\u4f8b\uff1a\u6309\u672c\u5730\u76ee\u5f55\u7ed3\u6784\u6279\u91cf\u5bfc\u51fa<\/h4>\n\n\n\n
\u5047\u8bbe\u6709\u5982\u4e0b\u5bfc\u51fa\u7ed3\u6784\uff1a<\/p>\n\n\n\n
\u7528\u6237A\/
\u8eab\u4efd\u8bc1\/
xxx.jpg (\u672c\u5730)
xxx.png (\u672c\u5730)
\u5934\u50cf\/
xxx.jpg (HTTP)
\u7528\u6237B\/
empty.txt<\/code><\/pre>\n\n\n\n\u6a21\u62df\u6570\u636e\u7ed3\u6784\uff1a<\/p>\n\n\n\n
\n- \u2022 zipGroup:<\/li>\n<\/ul>\n\n\n\n
import lombok.AllArgsConstructor;
import lombok.Data;
import java.util.List;
\/***
* @title
* @author shijiangyong
* @date 2025\/4\/28 16:36
**\/
@Data
@AllArgsConstructor
public class ZipGroup {
\/**
* \u7528\u6237\u540d\u3001\u6587\u4ef6\u540d
*\/
private String dirName;
private List<ZipSubDir> subDirs;
}<\/code><\/pre>\n\n\n\n\n- \u2022 zipGroupDir:<\/li>\n<\/ul>\n\n\n\n
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.util.List;
\/***
* @title
* @author shijiangyong
* @date 2025\/4\/28 16:37
**\/
@Data
@AllArgsConstructor
@NoArgsConstructor
public class ZipSubDir {
\/**
* \u5b50\u76ee\u5f55
*\/
private String subDirName;
private List<ZipFileRef> fileRefs;
}<\/code><\/pre>\n\n\n\n\n- \u2022 ZipFileRef:<\/li>\n<\/ul>\n\n\n\n
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
\/***
* @title
* @author shijiangyong
* @date 2025\/4\/28 16:38
**\/
@Data
@AllArgsConstructor
@NoArgsConstructor
public class ZipFileRef {
\/**
* \u6587\u4ef6\u540d
*\/
private String name;
\/**
* \u672c\u5730\u8def\u5f84
*\/
private String localPath;
\/**
* http\u8def\u5f84
*\/
private String httpUrl;
}<\/code><\/pre>\n\n\n\nController\u901a\u7528\u4ee3\u7801\uff1a<\/p>\n\n\n\n
package com.example.xiaoshitou.controller;
import com.example.xiaoshitou.service.ZipService;
import lombok.AllArgsConstructor;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
\/***
* @title
* @author shijiangyong
* @date 2025\/4\/28 16:50
**\/
@RestController
@RequestMapping(\"\/zip\")
@AllArgsConstructor
public class ZipController {
private final ZipService zipService;
\/**
* \u6253\u5305\u4e0b\u8f7d
* @param response
*\/
@GetMapping(\"\/download\")
public void downloadZip(HttpServletRequest request, HttpServletResponse response) {
zipService.downloadZip(request,response);
}
}<\/code><\/pre>\n\n\n\nService \u5c42\u4ee3\u7801\uff1a<\/p>\n\n\n\n
package com.example.xiaoshitou.service.impl;
import com.example.xiaoshitou.entity.ZipFileRef;
import com.example.xiaoshitou.entity.ZipGroup;
import com.example.xiaoshitou.entity.ZipSubDir;
import com.example.xiaoshitou.service.ZipService;
import com.example.xiaoshitou.utils.ZipDownloadUtils;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.compress.archivers.zip.ZipArchiveOutputStream;
import org.springframework.stereotype.Service;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.BufferedOutputStream;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;
import java.util.zip.Deflater;
\/***
* @title
* @author shijiangyong
* @date 2025\/4\/28 16:43
**\/
@Slf4j
@Service
public class ZipServiceImpl implements ZipService {
@Override
public void downloadZip(HttpServletRequest request, HttpServletResponse response) {
\/\/ ==== \u793a\u4f8b\u6570\u636e ====
List<ZipGroup> data = Arrays.asList(
new ZipGroup(\"\u5c0f\u660e\", Arrays.asList(
new ZipSubDir(\"\u8eab\u4efd\u8bc1(\u672c\u5730)\", Arrays.asList(
new ZipFileRef(\"\",\"E:\/software\/test\/1.png\",\"\"),
new ZipFileRef(\"\",\"E:\/software\/test\/2.png\",\"\")
)),
new ZipSubDir(\"\u5934\u50cf(http)\", Arrays.asList(
\/\/ \u767e\u5ea6\u968f\u4fbf\u627e\u7684
new ZipFileRef(\"\",\"\",\"https:\/\/pic4.zhimg.com\/v2-4d9e9f936b9968f53be22b594aafa74f_r.jpg\")
))
)),
new ZipGroup(\"\u5c0f\u654f\", Collections.emptyList())
);
try (BufferedOutputStream<\/em> bos = new BufferedOutputStream(response.getOutputStream());
ZipArchiveOutputStream<\/em> zipOut = new ZipArchiveOutputStream(bos)) {
String<\/em> fileName = \"\u8d44\u6599\u6253\u5305_\" + System.currentTimeMillis() + \".zip\";
ZipDownloadUtils.setResponse(request,response, fileName);
\/\/ \u5feb\u901f\u538b\u7f29
zipOut.setLevel(Deflater.BEST_SPEED);
for (ZipGroup group : data) {
String<\/em> groupDir = ZipDownloadUtils.safeName(group.getDirName()) + \"\/\";
List<ZipSubDir> subDirs = group.getSubDirs();
if (subDirs == null || subDirs.isEmpty()) {
groupDir = ZipDownloadUtils.safeName(group.getDirName()) + \"(\u65e0\u8d44\u6599)\/\";
ZipDownloadUtils.writeTextToZip(zipOut, groupDir + \"empty.txt\", \"\u8be5\u76ee\u5f55\u65e0\u4efb\u4f55\u8d44\u6599\");
continue;
}
for (ZipSubDir subDir : subDirs) {
String<\/em> subDirPath = groupDir + ZipDownloadUtils.safeName(subDir.getSubDirName()) + \"\/\";
List<ZipFileRef> fileRefs = subDir.getFileRefs();
if (fileRefs == null || fileRefs.isEmpty()) {
subDirPath = groupDir + ZipDownloadUtils.safeName(subDir.getSubDirName()) + \"(empty)\/\";
ZipDownloadUtils.writeTextToZip(zipOut, subDirPath + \"empty.txt\", \"\u8be5\u7c7b\u578b\u65e0\u8d44\u6599\");
continue;
}
for (ZipFileRef fileRef : fileRefs) {
if (fileRef.getLocalPath() != null && !fileRef.getLocalPath().isEmpty()) {
String<\/em> name = ZipDownloadUtils.getFileName(fileRef.getLocalPath());
fileRef.setName(name);
ZipDownloadUtils.writeLocalFileToZip(zipOut, fileRef.getLocalPath(), subDirPath + ZipDownloadUtils.safeName(fileRef.getName()));
} else if (fileRef.getHttpUrl() != null && !fileRef.getHttpUrl().isEmpty()) {
String<\/em> name = ZipDownloadUtils.getFileName(fileRef.getHttpUrl());
fileRef.setName(name);
ZipDownloadUtils.writeHttpFileToZip(zipOut, fileRef.getHttpUrl(), subDirPath + ZipDownloadUtils.safeName(fileRef.getName()));
}
}
}
}
zipOut.finish();
zipOut.flush();
response.flushBuffer();
} catch (Exception e) {
throw new RuntimeException(\"\u6253\u5305\u4e0b\u8f7d\u5931\u8d25\", e);
}
}
}<\/code><\/pre>\n\n\n\n3. \u5e38\u89c1\u95ee\u9898\u53ca\u5b89\u5168\u5efa\u8bae<\/h3>\n\n\n\n\n- \u2022\u00a0\u9632\u8def\u5f84\u7a7f\u8d8a\uff08Zip Slip\uff09\uff1a<\/strong>\u00a0\u6240\u6709\u76ee\u5f55\/\u6587\u4ef6\u540d\u52a1\u5fc5\u7528safeName\u8fc7\u6ee4\u7279\u6b8a\u5b57\u7b26<\/li>\n\n\n\n
- \u2022\u00a0\u5927\u6587\u4ef6\/\u5927\u6279\u91cf\uff1a<\/strong>\u00a0\u5efa\u8bae\u5206\u9875\u3001\u5206\u6279\u5904\u7406<\/li>\n\n\n\n
- \u2022\u00a0\u7a7a\u76ee\u5f55\u5199\u5165\uff1a<\/strong>\u00a0\u7edf\u4e00\u5199empty.txt\u6807\u8bc6\u7a7a\u76ee\u5f55<\/li>\n\n\n\n
- \u2022\u00a0\u672c\u5730\u6587\u4ef6\u4e0d\u5b58\u5728\uff1a<\/strong>\u00a0Zip\u5305\u5185\u5199\u5165\u63d0\u793a\u4fe1\u606f<\/li>\n\n\n\n
- \u2022\u00a0HTTP\u4e0b\u8f7d\u5931\u8d25\uff1a<\/strong>\u00a0Zip\u5305\u5185\u5199\u5165\u201c\u4e0b\u8f7d\u5931\u8d25\u201d\u63d0\u793a<\/li>\n\n\n\n
- \u2022\u00a0\u907f\u514d\u6cc4\u9732\u670d\u52a1\u5668\u7edd\u5bf9\u8def\u5f84\uff1a<\/strong>\u00a0\u4ec5\u5728\u65e5\u5fd7\u4e2d\u8bb0\u5f55\u672c\u5730\u8def\u5f84\uff0cZip\u5185\u4e0d\u66b4\u9732<\/li>\n\n\n\n
- \u2022\u00a0\u6743\u9650\u6821\u9a8c\uff1a<\/strong>\u00a0\u5b9e\u9645\u751f\u4ea7\u9700\u9a8c\u8bc1\u7528\u6237\u662f\u5426\u6709\u6743\u8bbf\u95ee\u6307\u5b9a\u6587\u4ef6<\/li>\n<\/ul>\n\n\n\n
4. \u603b\u7ed3<\/h3>\n\n\n\n
\u8fd9\u91cc\u4ecb\u7ecd\u4e86\u5982\u4f55\u4ece\u672c\u5730\u670d\u52a1\u5668\u8def\u5f84\u548cHTTP\u6df7\u5408\u8bfb\u53d6\u6587\u4ef6\u5e76Zip\u6253\u5305\u4e0b\u8f7d\uff0c\u76ee\u5f55\u7ed3\u6784\u7075\u6d3b\u53ef\u63a7\u3002\u53ef\u6839\u636e\u5b9e\u9645\u9700\u6c42\u6269\u5c55\u66f4\u591a\u6765\u6e90\u7c7b\u578b\uff08\u5982\u6570\u636e\u5e93\u3001\u5bf9\u8c61\u5b58\u50a8\u7b49\uff09\u3002<\/p>\n","raw":"","protected":false},"excerpt":{"rendered":"
\u9700\u8981\u5c06\u4e00\u6279\u6587\u4ef6\uff08\u53ef\u80fd\u5206\u5e03\u5728\u4e0d\u540c\u76ee\u5f55\u3001\u4e0d\u540c\u6765\u6e90\uff09\u6253\u5305\u6210Zip\u683c\u5f0f\uff0c\u6309\u76ee\u5f55\u7ed3\u6784\u5bfc\u51fa\u7ed9\u7528\u6237\u4e0b\u8f7d\u3002 1. \u6838\u5fc3\u601d\u8def 2. \u4ee3\u7801\u5b9e\u73b0 2.1 …<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"emotion":"","emotion_color":"","title_style":"","license":"","footnotes":""},"categories":[7],"tags":[],"class_list":["post-6595","post","type-post","status-publish","format-standard","hentry","category-spring-boot"],"post_thumbnail_image":"","content_first_image":null,"post_medium_image_300":"","post_thumbnail_image_624":"","post_frist_image":null,"post_medium_image":"","post_large_image":"","post_full_image":"","post_all_images":[],"videoAdId":"","listAd":"0","listAdId":"","listAdEvery":6,"total_comments":0,"category_name":"Spring Boot","post_date":"2025-09-29","like_count":"0","praiseWord":"\u9f13\u52b1","copyright_state":"","excitationAd":"0","rewardedVideoAdId":"","detailAdId":"","detailAd":"0","enterpriseMinapp":"0","audios":[],"postImageUrl":"https:\/\/wp-moto-1258805347.cos.ap-shanghai.myqcloud.com\/2023\/05\/20230519082947553.jpg","avatarurls":[],"related_posts":null,"pageviews":135,"next_post_id":6609,"next_post_title":"SpringBoot \u63d2\u4ef6\u5316\u5f00\u53d1\u6a21\u5f0f\uff0c\u5f3a\u70c8\u63a8\u8350\uff01","previous_post_id":6565,"previous_post_title":"SpringBoot\u6574\u5408\u5fae\u4fe1\u767b\u5f55\uff1aOpenID\u4e0eUnionID\u83b7\u53d6\u5168\u6d41\u7a0b\u89e3\u6790","_links":{"self":[{"href":"https:\/\/xinchewhd.com.cn\/index.php\/wp-json\/wp\/v2\/posts\/6595","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/xinchewhd.com.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/xinchewhd.com.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/xinchewhd.com.cn\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/xinchewhd.com.cn\/index.php\/wp-json\/wp\/v2\/comments?post=6595"}],"version-history":[{"count":1,"href":"https:\/\/xinchewhd.com.cn\/index.php\/wp-json\/wp\/v2\/posts\/6595\/revisions"}],"predecessor-version":[{"id":6596,"href":"https:\/\/xinchewhd.com.cn\/index.php\/wp-json\/wp\/v2\/posts\/6595\/revisions\/6596"}],"wp:attachment":[{"href":"https:\/\/xinchewhd.com.cn\/index.php\/wp-json\/wp\/v2\/media?parent=6595"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/xinchewhd.com.cn\/index.php\/wp-json\/wp\/v2\/categories?post=6595"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/xinchewhd.com.cn\/index.php\/wp-json\/wp\/v2\/tags?post=6595"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}