Laravel队列执行Excel导入报错：Could not find zip member求助

我使用Laravel 9开发应用，通过maatwebsite/excel库实现Excel导入导出功能，该功能在本地及服务器的非队列模式下均正常运行。但将Excel导入改为Laravel队列后台执行后，本地队列可正常工作，服务器却抛出以下错误：

PhpOffice\PhpSpreadsheet\Reader\Exception: Could not find zip member zip:///home/abc/public_html/storage/framework/cache/laravel-excel/laravel-excel-IBXMy3FjOUS4zPPBmdTRMctFwRMk31A5.xlsx#_rels/.rels in /home/abc/public_html/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Shared/File.php:159

Stack trace:
#0 /home/abc/public_html/vendor/phpoffice/phpspreadsheet/src/PhpSpreadsheet/Reader/Xlsx.php(400): PhpOffice\PhpSpreadsheet\Shared\File::assertFile()
...

可能原因及解决思路 #

1. 临时文件生命周期不匹配 #

非队列模式下，请求未结束时，maatwebsite/excel生成的临时文件（存储在storage/framework/cache/laravel-excel/）会被保留；但队列任务执行时，原Web请求已经结束，Laravel的缓存清理机制可能已删除该临时文件，导致PhpSpreadsheet无法读取。

解决方法：

• 上传文件时，先将Excel保存到storage/app/下的持久化目录（如storage/app/excel-uploads/），再将该持久化路径传给队列任务。
• 任务执行完成后，手动删除持久化文件避免占用空间。

示例代码：

// 上传阶段：保存到持久化目录
$uploadedFile = $request->file('excel');
$persistentPath = $uploadedFile->store('excel-uploads');

// 分发队列任务
ExcelImportJob::dispatch($persistentPath);

// 队列任务处理逻辑
public function handle()
{
    Excel::import(new YourImportClass(), storage_path('app/' . $this->persistentPath));
    
    // 清理文件
    Storage::delete($this->persistentPath);
}

2. 队列进程与Web服务权限不一致 #

服务器上队列进程（如php artisan queue:work）的运行用户和Web服务器用户（如www-data、apache）权限不同，导致队列进程无法读取缓存目录下的临时文件。

解决方法：

• 给storage/framework/cache/laravel-excel/目录设置权限为775，文件权限设置为664，确保两个用户组都有读写权限。
• 以Web服务器用户身份启动队列，例如：sudo -u www-data php artisan queue:work

3. PHP Zip扩展配置问题 #

服务器环境中PHP的zip扩展未启用或配置受限，导致无法通过zip://协议访问Excel文件内部的压缩成员。

解决方法：

• 执行php -m | grep zip验证扩展是否启用，未安装则通过包管理工具安装（如apt install php-zip）。
• 尝试将Excel文件复制到本地临时目录后再处理，绕开zip://协议的权限限制。

4. 缓存驱动差异影响 #

若服务器使用分布式缓存驱动（如Redis），而本地使用文件缓存，队列任务执行时无法读取Web请求生成的本地缓存文件。

解决方法：

• 确保队列任务与Web请求使用相同的缓存驱动；或直接采用思路1的方案，将文件保存到持久化存储而非缓存目录。

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