Laravel队列任务中创建的文件需停止队列才能删除的问题

问题根源 #

Windows的文件锁机制结合PHP在Windows下的资源释放逻辑导致：

• 调用$zip->close()后，PHP未必能立刻让操作系统释放该zip文件的独占锁
• Laravel队列worker进程会持续持有这个文件的引用，不管是在当前Job还是延迟Job中，只要worker进程未停止，文件锁就不会释放，自然无法删除

可行的解决办法 #

1. 强制释放文件锁（Windows专属） #

使用微软Sysinternals工具集里的handle.exe强制关闭文件句柄：

1. 下载Sysinternals Suite，提取handle.exe放到系统PATH目录（比如XAMPP的PHP目录）
2. 在Job中添加以下代码：

$zip->close();

// 调用handle.exe释放文件锁，-y参数自动确认操作
exec("handle.exe -c " . escapeshellarg($zipPath) . " -y");

unlink($zipPath);

注：worker进程需要具备管理员权限才能执行此命令

2. 改用PHP临时文件 #

利用tmpfile()创建临时文件，关闭流后系统会自动删除文件，完全绕开文件锁问题：

// 创建临时文件流
$tempStream = tmpfile();
$tempZipPath = stream_get_meta_data($tempStream)['uri'];

// 操作zip文件
$zip = new ZipArchive;
$zip->open($tempZipPath, ZipArchive::CREATE | ZipArchive::OVERWRITE);
$zip->addFile($outputFileLocation, 'screenshot.png');
$zip->close();

// 此处可对临时zip文件执行上传、发送等后续操作...

// 关闭流后，系统自动删除临时文件
fclose($tempStream);

3. 手动触发资源回收 #

强制销毁ZipArchive对象并触发PHP垃圾回收，给系统足够时间释放锁：

$zip->close();

// 销毁ZipArchive对象，释放引用
unset($zip);
// 强制触发PHP垃圾回收
gc_collect_cycles();
// 等待0.5秒，给操作系统释放文件锁的时间
usleep(500000);

unlink($zipPath);

4. 用独立进程执行删除 #

将删除操作放到独立的Artisan命令中，让新进程处理，避免worker进程持有文件锁：

• 先创建删除文件的Artisan命令：

// app/Console/Commands/DeleteTempFile.php
namespace App\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Support\Facades\File;

class DeleteTempFile extends Command
{
    protected $signature = 'temp:delete {path}';
    protected $description = 'Delete temporary file';

    public function handle()
    {
        $path = $this->argument('path');
        if (File::exists($path)) {
            File::delete($path);
        }
        return 0;
    }
}

• 在Job中调用该命令，以后台独立进程执行：

$zip->close();

// 构造命令并后台执行
$command = sprintf(
    'php %s artisan temp:delete %s',
    base_path('artisan'),
    escapeshellarg($zipPath)
);
exec($command . ' > NUL 2>&1 &');

内容的提问来源于stack exchange，提问作者Simon de Jong