Laravel批量下载多个PDF仅成功下载单个文件的问题排查

HTTP协议单次请求仅支持返回一个响应。你在循环中调用response()->download()时，第一次执行到该方法就会直接向浏览器返回对应单个PDF的文件流、终止请求后续执行，循环内剩余的逻辑、末尾的return 1都不会运行，自然只能下载到第一个匹配到的文件。

你可以根据业务场景选下面任意一种方案实现：

• 服务端打包为压缩包下载
  把所有待下载的PDF临时打包成一个ZIP文件，单次请求返回这个压缩包给用户，下载完成后自动删除服务器上的临时压缩包即可，是最通用的多文件下载方案，不会被浏览器拦截。Laravel环境下可以直接用PHP原生的ZipArchive扩展实现，参考代码：

  public function download(){
      $documents = Documents::all();
      // 生成不重名的临时压缩包路径
      $zipName = 'batch_documents_'.time().'.zip';
      $zipPath = public_path('uploads/temp/'.$zipName);
  
      $zip = new \ZipArchive();
      $zip->open($zipPath, \ZipArchive::CREATE | \ZipArchive::OVERWRITE);
      foreach ($documents as $document) {
          $filePath = public_path("/uploads/documents/".$document->filename);
          if (file_exists($filePath)) {
              // 向压缩包添加文件，第二个参数为压缩包内显示的文件名
              $zip->addFile($filePath, $document->filename);
          }
      }
      $zip->close();
  
      // 下载完成后自动删除临时压缩包
      return response()->download($zipPath)->deleteFileAfterSend(true);
  }
  

  注意提前确认你的PHP环境已经安装并开启了zip扩展，同时public_path('uploads/temp/')目录存在且有写入权限。
• 前端配合触发多文件下载
  后端接口不直接返回文件流，只返回所有待下载PDF的公网可访问直链列表，前端拿到列表后，循环创建隐藏的a标签逐个触发下载。如果文件数量较多，需要在两次触发之间加几百毫秒的间隔，避免被浏览器的多下载拦截规则拦住。

不要尝试在后端循环内连续返回下载响应，这种写法本身违背HTTP单次请求单响应的交互规则，不可能实现预期效果。

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