Laravel使用delay方法派发的队列任务始终处于pending状态无法执行如何解决

核心原因 #

• 使用了默认的sync同步队列驱动
  sync驱动设计为同步执行任务，本身不支持延迟能力。使用dispatchAfterResponse方法时，任务会在当前请求响应返回后同步执行，所以运行正常；但调用delay()方法时，sync驱动无法处理延迟逻辑，任务不会被正常调度执行，一直处于pending状态。
• 队列工作进程未正常运行
  若已切换到支持延迟的驱动（redis、database等），但未启动queue:work或queue:listen队列工作进程，所有入队的任务都不会被消费。
• 服务器时间不同步
  若应用部署服务器和队列工作进程所在服务器的时间不一致，会导致延迟任务的到期时间计算错误，任务达不到触发条件。
• 任务代码修改后未重启队列进程
  队列工作进程启动后会缓存已加载的代码，修改任务类逻辑后未重启队列进程，会导致任务执行异常。

解决步骤 #

1. 切换队列驱动为支持延迟的类型
   打开项目.env文件，修改队列连接配置：
   优先推荐使用redis驱动：

QUEUE_CONNECTION=redis

无redis环境可使用database驱动，需先执行迁移生成队列表：

php artisan queue:table
php artisan migrate

再修改.env配置：

QUEUE_CONNECTION=database

2. 启动队列工作进程
   执行以下命令启动队列消费进程，会自动处理普通任务和延迟任务：

php artisan queue:work

生产环境建议使用Supervisor管理队列进程，保证进程常驻运行。
3. 校验服务器时间
保证应用服务器和队列服务器的时间一致，可配置NTP服务自动同步时间。
4. 修改任务代码后重启队列

php artisan queue:restart

可选优化 #

可在任务类中明确指定使用的队列连接，避免全局配置变更影响任务执行：

<?php

namespace App\Jobs;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;

class DeleteCreatedFiles implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    // 明确指定支持延迟的队列连接
    public $connection = 'redis';

    protected $file;

    public function __construct($file)
    {
        $this->file = $file;
    }

    public function handle()
    {
        unlink($this->file);
    }
}

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