如何为Laravel Cron任务设置运行优先级？指定任务优先执行

Laravel 本身没有提供直接的任务优先级配置项，但可以通过以下几种方式实现你需要的「WeeklyCron 优先执行，其他任务暂存等待」的需求：

方式一：利用互斥锁+条件判断 #

通过withoutOverlapping给每周任务生成缓存锁，其他高频任务仅在锁不存在时执行，确保WeeklyCron运行期间其他任务暂停：

// 给每周任务添加互斥锁，锁有效期设为足够完成任务的时长（示例为60分钟）
$schedule->command(WeeklyCron::class)
    ->weekly()->fridays()->timezone('America/New_York')->at('23:59')
    ->withoutOverlapping(60);

// 每分钟执行的邮件任务，仅当WeeklyCron未运行时触发
$schedule->command(CronDelayMailCommand::class)
    ->everyMinute()
    ->when(function () {
        // 检查WeeklyCron的调度锁是否存在
        return !Cache::has('laravel_schedule:'.sha1(WeeklyCron::class));
    });

$schedule->command(QuickStartMailCommand::class)
    ->everyMinute()
    ->when(function () {
        return !Cache::has('laravel_schedule:'.sha1(WeeklyCron::class));
    });

原理：withoutOverlapping会在任务启动时生成缓存锁，任务完成后自动释放；其他任务通过when条件判断锁状态，锁存在则跳过本次执行。

方式二：队列优先级配置（适合异步任务场景） #

如果邮件类任务本身可以异步执行，可将不同任务分配到不同优先级队列，让队列Worker优先处理高优先级任务：

// 将高频邮件任务分配到默认队列
$schedule->command(CronDelayMailCommand::class)->everyMinute()->onQueue('default');
$schedule->command(QuickStartMailCommand::class)->everyMinute()->onQueue('default');

// 将每周任务分配到高优先级队列
$schedule->command(WeeklyCron::class)
    ->weekly()->fridays()->timezone('America/New_York')->at('23:59')
    ->onQueue('high');

启动队列Worker时指定优先级顺序：

php artisan queue:work --queue=high,default

原理：Worker会优先处理high队列的任务，待高优先级队列清空后再处理default队列任务。

方式三：任务依赖（适合同时间触发的场景） #

如果需要WeeklyCron执行完成后再触发其他任务，可使用then方法，但仅适合同一调度周期内的任务，需配合条件判断跳过原高频任务的同期执行：

// 每周任务执行完成后，手动触发邮件任务
$schedule->command(WeeklyCron::class)
    ->weekly()->fridays()->timezone('America/New_York')->at('23:59')
    ->then(function () {
        Artisan::call(CronDelayMailCommand::class);
        Artisan::call(QuickStartMailCommand::class);
    });

// 给高频邮件任务添加条件，排除每周五23:59的执行
$schedule->command(CronDelayMailCommand::class)
    ->everyMinute()
    ->when(function () {
        $now = Carbon::now('America/New_York');
        return !($now->isFriday() && $now->hour === 23 && $now->minute === 59);
    });

$schedule->command(QuickStartMailCommand::class)
    ->everyMinute()
    ->when(function () {
        $now = Carbon::now('America/New_York');
        return !($now->isFriday() && $now->hour === 23 && $now->minute === 59);
    });

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