Zip文件流式传输抛CRC错误，添加finish()后仅压缩单个文件

咱们先拆解下你遇到的两个核心矛盾：ZIP文件Windows解压CRC校验失败，以及添加zipOutputStream.finish()后仅单个文件被压缩，这本质是没搞懂ZIP输出流的生命周期和JAX-WS流式传输的适配逻辑。

问题根源解析 #

1. CRC错误的原因：
   最初的代码没有完成ZIP流的收尾工作——ZIP文件的核心元数据（Central Directory）没被写入，Windows解压工具依赖这个目录校验文件完整性，自然会抛出CRC错误。
2. 多文件丢失的原因：
   zipOutputStream.finish()会完成ZIP流的元数据写入，但调用后ZIP流就进入了不可写入的状态。如果你的代码在处理完第一个文件就调用了它，后续文件根本没法再写入ZIP流，自然只会保留单个文件。

正确实现思路 #

在JAX-WS流式传输场景下，要做到：

• 逐个读取数据库BLOB、解压，依次写入ZIP输出流
• 所有文件处理完成后，再调用finish()完成ZIP元数据写入
• 绝对不能提前关闭或收尾ZIP流，同时要让JAX-WS管理响应输出流的生命周期

修正后的代码示例 #

假设你的JAX-WS方法返回StreamingOutput，可以这样调整：

@WebMethod
public StreamingOutput downloadFiles() throws SQLException, IOException {
    return outputStream -> {
        // 将ZIP流绑定到JAX-WS的响应输出流
        try (ZipOutputStream zipOut = new ZipOutputStream(outputStream)) {
            String sql = "SELECT file_name, file_blob FROM your_files_table";
            try (Connection conn = getDatabaseConnection();
                 PreparedStatement pstmt = conn.prepareStatement(sql);
                 ResultSet resultSet = pstmt.executeQuery()) {

                while (resultSet.next()) {
                    String fileName = resultSet.getString("file_name");
                    Blob fileBlob = resultSet.getBlob("file_blob");

                    // 读取BLOB并解压（这里假设你用GZIP解压，可替换为你的解压逻辑）
                    try (InputStream blobIn = fileBlob.getBinaryStream();
                         GZIPInputStream gzipIn = new GZIPInputStream(blobIn)) {

                        // 向ZIP流添加新条目
                        ZipEntry zipEntry = new ZipEntry(fileName);
                        zipOut.putNextEntry(zipEntry);

                        // 流式写入解压后的内容（大文件也不会占内存）
                        byte[] buffer = new byte[4096];
                        int bytesRead;
                        while ((bytesRead = gzipIn.read(buffer)) != -1) {
                            zipOut.write(buffer, 0, bytesRead);
                        }

                        zipOut.closeEntry(); // 关闭当前条目，确保内容完全写入
                    }
                }
                // 所有文件处理完，再收尾ZIP流，写入元数据
                zipOut.finish();
            }
        }
    };
}

关键注意事项 #

• 不要提前调用finish()：必须等所有文件都添加到ZIP流后再执行，否则后续putNextEntry()会抛出异常。
• 务必关闭ZipEntry：每个文件写入完成后调用zipOut.closeEntry()，避免数据残留导致文件损坏。
• 流式处理大文件：不要把整个BLOB解压后读到内存（比如用ByteArrayOutputStream），直接流式写入ZIP流，避免内存溢出。
• 资源交给框架管理：JAX-WS会负责响应输出流的关闭，不要手动关闭它，只需要管理好自己创建的ZIP流、数据库连接等资源。

这样调整后，既能解决CRC校验错误，又能正确压缩所有文件，完美适配JAX-WS的流式传输需求。

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