AJAX下载Java生成的Zip文件无法解压，求问题排查

核心问题分析 #

你遇到的Zip文件损坏问题，主要来自两个方面：

1. 前端AJAX默认处理文本响应：二进制的Zip数据被自动转成UTF-8字符串，破坏了原始二进制结构，导致解压工具无法识别。
2. 后端路径拼接与流操作不规范：字符串拼接路径容易出错，手动关闭流的顺序不当可能导致Zip文件写入不完整。

前端修复（关键） #

修改AJAX请求，指定responseType: 'arraybuffer'，确保直接接收二进制数据，避免转码损坏：

$.ajax({
    type: "POST",
    url: url,
    contentType: "application/xml",
    data: xmlString,
    async: false,
    responseType: 'arraybuffer', // 必须添加：强制接收二进制数组
    success: function(response, status, jqXHR) {
        var filename = "";
        var disposition = jqXHR.getResponseHeader("content-disposition");
        if (disposition && disposition.indexOf("attachment") !== -1) {
            var filenameRegex = /filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/;
            var matches = filenameRegex.exec(disposition);
            if (matches != null && matches[1]) {
                filename = matches[1].replace(/['"]/g, "");
            }
        }
        var blob = new Blob([response], {type: "application/zip"}); // 类型更改为application/zip
        var link = document.createElement("a");
        link.href = window.URL.createObjectURL(blob);
        link.setAttribute("download", filename);
        document.body.appendChild(link);
        link.click();
        link.remove();
    },
    error: function(error) {
        console.log(error);
    }
});

后端修复 #

1. 修复路径拼接问题 #

不要用字符串拼接路径，用File构造函数避免因fullPath末尾无斜杠导致的路径错误：

// 替换原Zip文件创建方式
File zipFile = new File(path, "download.zip");

2. 规范流操作（自动关闭+完整写入） #

使用try-with-resources自动管理流，同时记得关闭每个ZipEntry，确保Zip结构完整：

File path = new File(fullPath);
if(path.exists() && !path.isDirectory()) { path.delete(); }

// 先判断路径是否为目录，避免listFiles返回null
if (!path.isDirectory()) {
    throw new IllegalArgumentException("Path is not a directory: " + path.getAbsolutePath());
}

File[] files = path.listFiles((dir, name) -> filesToDownload.contains(name));
if (files == null || files.length == 0) {
    throw new IllegalArgumentException("No files in path " + path.getAbsolutePath());
}

// 用try-with-resources自动关闭流
try (FileOutputStream fos = new FileOutputStream(new File(path, "download.zip"));
     ZipOutputStream zipOut = new ZipOutputStream(fos)) {
    for (File zipThis : files) {
        try (FileInputStream fis = new FileInputStream(zipThis)) {
            ZipEntry zipEntry = new ZipEntry(zipThis.getName());
            zipOut.putNextEntry(zipEntry);
            byte[] bytes = new byte[2048];
            int length;
            while ((length = fis.read(bytes)) >= 0) {
                zipOut.write(bytes, 0, length);
            }
            zipOut.closeEntry(); // 必须关闭当前条目，保证Zip结构正确
        }
    }
}

// 读取Zip文件并返回
fileBytes = Files.readAllBytes(Paths.get(new File(path, "download.zip").getAbsolutePath()));
headers.setContentType(MediaType.parseMediaType("application/zip"));
headers.setContentDispositionFormData("attachment", "download.zip");
headers.setContentLength(fileBytes.length);
return new ResponseEntity<>(fileBytes, headers, HttpStatus.OK);

3. 可选优化：避免临时文件 #

直接在内存中生成Zip，无需写入磁盘，减少IO操作：

try (ByteArrayOutputStream baos = new ByteArrayOutputStream();
     ZipOutputStream zipOut = new ZipOutputStream(baos)) {
    for (File zipThis : files) {
        try (FileInputStream fis = new FileInputStream(zipThis)) {
            ZipEntry zipEntry = new ZipEntry(zipThis.getName());
            zipOut.putNextEntry(zipEntry);
            byte[] bytes = new byte[2048];
            int length;
            while ((length = fis.read(bytes)) >= 0) {
                zipOut.write(bytes, 0, length);
            }
            zipOut.closeEntry();
        }
    }
    zipOut.finish(); // 完成Zip写入
    fileBytes = baos.toByteArray();
}

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