springboot-单文件下载、多文件下载（zip）

最新推荐文章于 2025-10-26 19:42:14 发布

转载最新推荐文章于 2025-10-26 19:42:14 发布 · 1.5k 阅读

50 工作中基础学习专栏收录该内容

114 篇文章

订阅专栏

本文探讨了在项目中实现批量图片下载功能的多种尝试，包括前后台循环下载的失败经验，最终采用压缩多个文件为ZIP格式的成功方案。详细解析了使用ZipOutputStream压缩流创建临时文件、将多个文件写入压缩文件、通过输出流传输给客户端并处理中文文件名乱码等问题。

一：场景：

项目中需要做批量下载图片的功能。

思路一：后台拿到图片信息再循环的方式，实践后发现行不通，只能下载第一个文件。

原因：当第一次输出流关闭后请求结束，链接关闭，后续的循环已无意义。

思路二：后台不行就在前台进行循环，多次请求。实践后发现还是行不通，仍只能下载一个文件。

原因：没想明白希望大佬看到告知，感谢！

思路三：没办法只能将多个文件压缩后返回,实践成功。

原理：

1.创建压缩流写到服务器上的压缩文件（临时文件）

2.把服务器上要下载的多个文件写入该压缩文件

3.把压缩文件通过输出流传输给客户端（注意：必须在zipoutputstream流关闭后，否则下载下的文件会报不可预料的压缩文件末端）

4.删除服务器上的临时文件

二：遇到的问题：

1.一开始使用ajax请求方式传送请求，即使后台不报错浏览器也没有进行下载操作？

解释：因为response的原因，一般请求浏览器是会处理服务器输出的response，文件的下载是以二进制形式进行的。但是ajax请求只是个“字符型”的请求，即请求的内容是以文本类型存放的。所以虽然可以读取到返回的response，但只是读取而已，是无法执行的，说白点就是js无法调用到浏览器的下载处理机制和程序。

解决：

window.location.href = "/imgUpload/imgdownload?names="+names+"&paths="+paths;

2.使用ajax传输数组到后台时，后台接收到的值为null

解决：添加traditional : true

解释：jQuery需要调用jQuery.param序列化参数，默认traditional为false，就是说jquery会深度序列化参数对象，但servelt api无法处理深度序列化的参数对象，所以通过设置traditional 为true阻止深度序列化。

3.通过window.location.href拼接数组参数时向后台传递会报错。

解决：先对参数进行编码后再传递var paths = encodeURI(encodeURI(imgUrlList));后台配合解码可以获得编码前的内容

后端解码：String realFileName = java.net.URLDecoder.decode(names[i],"UTF-8");

原因：传递的参数中包含特殊的字符，不符合url的规范，所以先对其进行编码。值得一提的是编码后可以直接传递数组。

之后就是后台代码的编写了

4.返回文件名中文乱码。

response.setHeader( "Content-Disposition", "attachment;filename=" + new String( fileName.getBytes("gb2312"), "ISO8859-1" ) );

参考：https://www.cnblogs.com/feiqihang/p/3544498.html

单文件：

public void downImg(HttpServletResponse response,String filename,String path ){
if (filename != null) {
FileInputStream is = null;
BufferedInputStream bs = null;
OutputStream os = null;
try {
File file = new File(path);
if (file.exists()) {
//设置Headers
response.setHeader("Content-Type","application/octet-stream");
//设置下载的文件的名称-该方式已解决中文乱码问题
response.setHeader("Content-Disposition","attachment;filename=" + new String( filename.getBytes("gb2312"), "ISO8859-1" ));
is = new FileInputStream(file);
bs =new BufferedInputStream(is);
os = response.getOutputStream();
byte[] buffer = new byte[1024];
int len = 0;
while((len = bs.read(buffer)) != -1){
os.write(buffer,0,len);
}
}else{
String error = Base64Util.encode("下载的文件资源不存在");
response.sendRedirect("/imgUpload/imgList?error="+error);
}
}catch(IOException ex){
ex.printStackTrace();
}finally {
try{
if(is != null){
is.close();
}
if( bs != null ){
bs.close();
}
if( os != null){
os.flush();
os.close();
}
}catch (IOException e){
e.printStackTrace();
}
}
}
}

多文件下载：下载的是zip格式

前段js代码+后端controller代码

/**
* 图片下载
*/
function downloadimg() {
//获取所有被选的图片的名称与绝对路径放入数组
var list = $(".activecheck");
var imgNameList = [];
var imgUrlList = [];
for(var i = 0;i<list.length;i++){
var b = $(list[i].childNodes[2]).attr("data-url");
imgNameList.push(list[i].childNodes[3].innerText);//图片名称
imgUrlList.push(b);//图片绝对路径
}
var paths = encodeURI(encodeURI(imgUrlList));
var names = encodeURI(encodeURI(imgNameList));
//将名称传入后台
window.location.href = "/imgUpload/imgdownload?names="+names+"&paths="+paths;
}

/**
* 下载
* @param response
*/
@RequestMapping(value = "/imgdownload", method = RequestMethod.GET)
public void imgDownload(@SessionAttribute(MyInterceptor.SESSION_KEY) SessionInfo info,HttpServletResponse response,String [] names,String [] paths) {
//存放--服务器上zip文件的目录
String directory = "D:\\repository\\"+info.getName();
File directoryFile=new File(directory);
if(!directoryFile.isDirectory() && !directoryFile.exists()){
directoryFile.mkdirs();
}
//设置最终输出zip文件的目录+文件名
SimpleDateFormat formatter = new SimpleDateFormat("yyyy年MM月dd日HH时mm分ss秒");
String zipFileName = formatter.format(new Date())+".zip";
String strZipPath = directory+"\\"+zipFileName;
ZipOutputStream zipStream = null;
FileInputStream zipSource = null;
BufferedInputStream bufferStream = null;
File zipFile = new File(strZipPath);
try{
//构造最终压缩包的输出流
zipStream = new ZipOutputStream(new FileOutputStream(zipFile));
for (int i = 0; i<paths.length ;i++){
//解码获取真实路径与文件名
String realFileName = java.net.URLDecoder.decode(names[i],"UTF-8");
String realFilePath = java.net.URLDecoder.decode(paths[i],"UTF-8");
File file = new File(realFilePath);
//TODO:未对文件不存在时进行操作，后期优化。
if(file.exists())
{
zipSource = new FileInputStream(file);//将需要压缩的文件格式化为输入流
/**
* 压缩条目不是具体独立的文件，而是压缩包文件列表中的列表项，称为条目，就像索引一样这里的name就是文件名,
* 文件名和之前的重复就会导致文件被覆盖
*/
ZipEntry zipEntry = new ZipEntry(realFileName);//在压缩目录中文件的名字
zipStream.putNextEntry(zipEntry);//定位该压缩条目位置，开始写入文件到压缩包中
bufferStream = new BufferedInputStream(zipSource, 1024 * 10);
int read = 0;
byte[] buf = new byte[1024 * 10];
while((read = bufferStream.read(buf, 0, 1024 * 10)) != -1)
{
zipStream.write(buf, 0, read);
}
}
}
} catch (Exception e) {
e.printStackTrace();
} finally {
//关闭流
try {
if(null != bufferStream) bufferStream.close();
if(null != zipStream){
zipStream.flush();
zipStream.close();
}
if(null != zipSource) zipSource.close();
} catch (IOException e) {
e.printStackTrace();
}
}
//判断系统压缩文件是否存在：true-把该压缩文件通过流输出给客户端后删除该压缩文件 false-未处理
if(zipFile.exists()){
downImg(response,zipFileName,strZipPath);
zipFile.delete();
}
}