Laravel队列仅手动启动生效，Kernel命令调度无响应问题排查

问题描述 #

配置了如下Kernel.php文件：

<?php

namespace App\Console;

use Illuminate\Console\Scheduling\Schedule;
use Illuminate\Foundation\Console\Kernel as ConsoleKernel;

class Kernel extends ConsoleKernel
{
    /**
     * Define the application's command schedule.
     *
     * @param  \Illuminate\Console\Scheduling\Schedule  $schedule
     * @return void
     */
    protected function schedule(Schedule $schedule)
    {
        \Log::info("hit");
        $schedule->command('queue:restart')->everyFiveMinutes();
        $schedule->command('queue:work')->name('queue_work_name')->withoutOverlapping()->runInBackground();
    }
}

已设置每分钟执行的Cron任务，日志正常打印"hit"说明调度器本身在运行，但队列没有任何工作迹象；但在终端执行php artisan queue:work --once时队列能正常处理任务。

排查与解决步骤 #

• 显式指定队列连接：queue:work默认使用default队列连接，但如果你的队列配置了非默认连接（如Redis、Database），调度任务中需要明确指定，示例：

  $schedule->command('queue:work redis')
           ->name('queue_work_name')
           ->withoutOverlapping()
           ->runInBackground();
  

• 修正Cron工作目录：Cron执行时的默认目录并非项目根目录，会导致Artisan无法加载正确配置。修改Cron命令为：

  * * * * * cd /绝对路径/到/你的项目 && php artisan schedule:run >> /dev/null 2>&1
  

• 添加调度日志排查错误：给队列调度任务添加输出日志，便于定位执行时的异常：

  $schedule->command('queue:work')
           ->name('queue_work_name')
           ->withoutOverlapping()
           ->runInBackground()
           ->appendOutputTo(storage_path('logs/queue_schedule.log'));
  

  查看storage/logs/queue_schedule.log文件，即可获取任务执行时的错误信息（如权限不足、依赖缺失等）。
• 检查withoutOverlapping锁机制：该方法依赖缓存驱动实现任务互斥，如果缓存配置异常（如文件缓存权限不足、Redis连接失败），会导致任务误判为已有实例运行。可以临时移除withoutOverlapping测试，或检查缓存驱动的配置与权限。
• 确保PHP环境一致：Cron使用的PHP版本可能与终端不一致，导致缺少必要扩展（如Redis扩展）。执行which php获取终端的PHP路径，然后在Cron命令中使用完整路径：

  * * * * * cd /绝对路径/到/你的项目 && /usr/local/bin/php artisan schedule:run >> /dev/null 2>&1
  

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