Laravel使用Redis驱动时队列任务未后台执行的问题排查

问题场景 #

我编写了如下代码：

Job 实现 #

public function handle(): void
{
    sleep(5);
    echo "hello!";
}

控制器代码 #

public function index() {
    ProcessPodcast::dispatch();
    echo "finished!";
}

路由配置 #

Route::get("/job", [JobTest::class, 'index']);

执行 php artisan queue:work 后访问 /job 路由，页面会等待5秒才显示内容，但预期队列任务应在后台异步执行，页面无延迟。已尝试切换为Redis队列驱动：

QUEUE_CONNECTION=redis

终端无报错，求排查方向。

可能的原因及解决办法 #

• 队列配置未生效：
  配置缓存可能导致 .env 里的队列驱动设置不生效，执行以下命令清除配置缓存：

  php artisan config:clear
  

  可以在控制器中添加 dd(config('queue.default')) 确认当前实际使用的队列驱动是否为redis。

• Job类硬编码同步驱动：
  检查 ProcessPodcast Job类是否存在强制设置同步连接的代码，比如：

  public $connection = 'sync';
  

  若有此类代码，会强制任务同步执行，需移除该配置。

• Worker未监听正确连接：
  启动Worker时明确指定Redis连接，避免默认配置异常：

  php artisan queue:work redis
  

• Redis服务未运行：
  用 redis-cli ping 测试Redis连接状态，若Redis未启动，Laravel无法将任务推入队列，可能自动 fallback 到同步执行。

• 任务未成功推入队列：
  用 redis-cli 执行 keys queues:* 查看队列是否有任务堆积。若没有任务，说明任务未被正确推入，大概率是配置问题导致直接同步执行。

• 自动 fallback 到同步驱动：
  当指定的队列驱动不可用时，Laravel会自动切换为sync同步驱动，导致任务在请求进程内执行，阻塞页面。需确保队列驱动配置正确且对应服务正常运行。

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