最近在做需求时,需要做一个导入的功能,页面有一个下载导入模版的按钮,点击按钮返回一个压缩包文件。我将压缩包放到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>