最近在做需求时,需要做一个导入的功能,页面有一个下载导入模版的按钮,点击按钮返回一个压缩包文件。我将压缩包放到resources下的template文件夹中。提供一个get请求接口读取资源文件夹下的压缩包直接返回,功能简单,调试时接口也可以正常返回压缩包。但是手动解压压缩包发现文件已损坏。
bug复现
第一步:将压缩包放到项目的资源目录下,结构如下:
resources
└─template
└─数据导入模版.zip
第二步:提供模版下载接口:
/**
* 下载.zip模板文件
* @return 文件下载响应
*/
@GetMapping("/downloadTemplate")
public void downloadTemplate(HttpServletResponse response) {
try (InputStream inputStream = ResourceUtil.getStream("template/数据导入模版.zip");
OutputStream outputStream = response.getOutputStream()) {
// 设置文件名
String fileName = URLEncoder.encode("数据导入模版.zip", StandardCharsets.UTF_8)
.replaceAll("\\+", "%20");
response.setHeader("Content-Disposition", "attachment;filename=" + fileName);
// 设置响应类型
response.setContentType("application/octet-stream");
IoUtil.copy(inputStream, outputStream);
// 强制刷新输出流,确保所有字节都写入响应
outputStream.flush();
}catch (Exception e) {
log.error("文件下载失败:",e);
throw new RuntimeException("导入模板下载失败");
}
}
调用接口将返回的压缩包保存到本地,发现无法解压。以为是hutool工具代码有问题,更换了java原生代码发现还是不行。提取了压缩包的md5发现和我放到资源文件目录的md5不一致,到网上一搜才知道是maven编译时会将资源文件夹下的文件也编译一遍,导致编译后的文件与源文件不一致。
解决方案
在pom.xml中添加编译插件,排除不需要编译的文件
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<configuration>
<nonFilteredFileExtensions>
<nonFilteredFileExtension>zip</nonFilteredFileExtension>
</nonFilteredFileExtensions>
</configuration>
</plugin>