Spring Boot返回多Excel文件响应Chrome未触发下载如何解决

核心问题原因 #

1. 浏览器兼容性问题：Chromium内核浏览器（Chrome、Edge等）不支持multipart/x-mixed-replace类型响应触发多文件下载，该机制仅Firefox有有限支持，这是Chrome无下载响应、识别为图片的根本原因。
2. 响应格式错误：你编写的多部分响应结构不符合HTTP规范，多余的换行符、系统换行符（println输出的换行符随操作系统变化，HTTP要求固定为\r\n）被写入Excel二进制内容中，导致Firefox下载的文件尾部多出异常字节，打开时提示内容损坏。
3. 文件名未规范处理：未用引号包裹文件名，也没有做URL编码，遇到特殊字符或中文会出现文件名乱码问题。

推荐解决方案：打包为ZIP返回 #

该方案兼容性100%，所有浏览器都支持，也不会出现文件损坏问题，实现代码如下：

@GetMapping("/${pageLinks.excelPage}/download")
public void getExcelDownload(HttpServletResponse response) throws IOException {
    // 设置zip响应头
    response.setContentType("application/zip");
    response.setHeader("Content-Disposition", "attachment; filename=\"excel_pack.zip\"");

    ByteArrayOutputStream inventorySheet = inventoryExcel.export();
    ByteArrayOutputStream deductionsSheet = deductionsExcel.export();

    try (ZipOutputStream zipOut = new ZipOutputStream(response.getOutputStream())) {
        // 写入第一个文件
        ZipEntry deductionsEntry = new ZipEntry("Deductions.xlsx");
        zipOut.putNextEntry(deductionsEntry);
        deductionsSheet.writeTo(zipOut);
        deductionsSheet.close();
        zipOut.closeEntry();

        // 写入第二个文件
        ZipEntry inventoryEntry = new ZipEntry("Inventory.xlsx");
        zipOut.putNextEntry(inventoryEntry);
        inventorySheet.writeTo(zipOut);
        inventorySheet.close();
        zipOut.closeEntry();

        zipOut.flush();
    }
}

备选方案：前端触发两次独立下载 #

如果你确实需要直接返回两个独立的Excel文件，不要使用后端多部分响应的方案，调整逻辑如下：

• 后端分别写两个单文件下载接口，或者同一个接口加参数区分返回的文件类型
• 前端调用接口后，动态生成两个a标签，设置download属性分别触发点击，Chromium内核浏览器支持同一上下文下触发最多10次下载请求。

内容的提问来源于stack exchange，提问作者Brett53559