下载多文件ZIP压缩包出错，请求排查压缩包创建问题

开发者阿泽

2026-6-25

问题分析与排查方案

关于压缩包大小的疑问

265,530字节（约259KB）的压缩包包含两个PDF文件是完全正常的。PDF本身属于压缩率较低的文件格式，两个小尺寸PDF打包后的大小符合预期，排除大小导致的损坏问题。

核心问题排查与修复

1. 修复ZIP打包的文件路径嵌套问题

你的代码中$zip->addFile($filePath)仅传入源文件路径，未指定压缩包内的目标文件名。这会导致ZIP中包含完整的服务器存储路径（例如storage/app/files/news/downloadable/xxx.pdf），部分解压工具无法识别这种嵌套路径，或出现文件覆盖、解压失败的情况。

修改addFile调用，仅保留原文件名：

if (file_exists($filePath)) {
    // 仅将文件名存入ZIP，避免路径嵌套
    $zip->addFile($filePath, basename($filePath));
}

2. 验证ZIP文件创建状态

当前代码未检查ZipArchive::open的返回值，如果服务器对public目录无写入权限，或ZIP创建失败，后续操作会生成损坏的空文件。添加状态检查：

$zip = new \ZipArchive();
$openStatus = $zip->open($zipFilePath, \ZipArchive::CREATE | \ZipArchive::OVERWRITE);

// 抛出明确的创建失败异常
if ($openStatus !== true) {
    throw new \Exception("ZIP创建失败，错误码: $openStatus");
}

3. 自动清理临时ZIP文件

当前代码会在public目录遗留all_certificates.zip文件，多次请求后会堆积垃圾文件，甚至因文件被占用导致后续打包失败。在下载响应中添加自动删除逻辑：

return response()->download($zipFilePath)->deleteFileAfterSend(true);

4. 验证服务器端ZIP文件完整性

手动到服务器public目录找到生成的all_certificates.zip，尝试直接打开：

若服务器上能正常打开：说明打包流程无问题，问题出在下载响应。可检查Laravel的download方法是否自动设置了正确的Content-Type（应为application/zip）。
若服务器上也打不开：说明打包过程有误，结合上述步骤检查目录权限、文件路径、ZIP创建状态。

5. 确认文件路径一致性

虽然单独下载正常，但需确认打包时的$filePath与单独下载时的路径是否完全一致。例如单独下载用public_path($certificate->path)，但打包用storage_path('app/' . $certificate->path)，路径不匹配可能读取到错误文件（如空文件），导致ZIP损坏。

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