Laravel 为每个高级付费用户配置定时调度任务的实现咨询

先捋清楚Laravel定时任务的底层逻辑，别被网上的“动态调度”教程绕晕：Laravel没有持久化存储的定时任务列表，平时配置的系统Cron会每分钟调用一次php artisan schedule:run命令，每次命令启动时，Laravel会从头执行App\Console\Kernel里的schedule方法，现算本次要跑哪些任务，跑完就销毁进程，下次启动再重新算。不存在什么“永久新增一个定时任务”“永久删除一个定时任务”的持久化操作，所有动态规则直接在每次算任务列表的时候用业务数据过滤就行。

具体问题对应解答 #

• 如何在Laravel中动态添加定时调度任务？
  不用整什么运行时注入调度的花活，直接在schedule方法里查你的业务数据，把符合条件的任务循环注册上就行，示例代码：

// app/Console/Kernel.php
protected function schedule(Schedule $schedule)
{
    // 分块查所有有效高级会员订阅，避免数据量太大把内存撑爆
    PremiumSubscription::where('is_active', true)
        ->chunkById(200, function ($subscriptions) use ($schedule) {
            foreach ($subscriptions as $sub) {
                // 从用户的订阅时间里拆出来周几、具体时分秒，匹配周度发奖励的规则
                $weekday = $sub->subscribed_at->dayOfWeek;
                $runTime = $sub->subscribed_at->format('H:i:s');
                $schedule->job(new CreditPremiumUser($sub->user_id))
                    ->weeklyOn($weekday, $runTime)
                    ->withoutOverlapping() // 防止同一个用户的奖励任务重复跑
                    ->onQueue('member_benefit');
            }
        });
}

要是你家有效会员量超过10万，上面给每个用户单独注册任务的方式性能会有点差，直接换更轻量的方案：只注册一个每分钟跑的固定任务，任务里查当前时间点刚好到发放周期的有效用户，批量派发放奖励的Job就行，不管多少用户量都能扛，代码参考：

// Kernel里只需要加这一行固定调度
$schedule->job(new BatchDispatchPremiumCredit())->everyMinute();

// BatchDispatchPremiumCredit 这个Job里的逻辑
public function handle()
{
    $currentWeekday = now()->dayOfWeek;
    $currentHourMinute = now()->format('H:i');

    // 筛出来当前周几、当前分钟刚好到订阅发放时间的有效会员
    PremiumSubscription::where('is_active', true)
        ->whereRaw('WEEKDAY(subscribed_at) = ?', [$currentWeekday])
        ->whereRaw('DATE_FORMAT(subscribed_at, "%H:%i") = ?', [$currentHourMinute])
        ->pluck('user_id')
        ->each(fn($userId) => CreditPremiumUser::dispatch($userId));
}

• 实现该场景是否需要将定时任务存储到数据库的tasks表中统一管理？
  完全没必要。你的会员订阅表本身就是最准的数据源，用户什么时候订阅的、现在有没有退订这些信息全在上面，单独建tasks表反而要多做一层数据同步，万一哪次用户退订了你忘了同步tasks表的状态，直接就给退订用户发错奖励。直接拿订阅表当调度的唯一判断依据就行，少写冗余逻辑少出bug。

• 用户退订高级会员时如何移除对应的定时任务？
  你现在在Job里加用户订阅状态校验的逻辑非常对，必须留着，这是最后一道兜底，不管上层调度出什么问题，这层校验都能拦住错发。
  用上面说的两种动态调度方案，你根本不需要专门写移除任务的逻辑：用户退订的时候把对应订阅记录的is_active改成false，下次调度启动算任务列表的时候，自动就把这个用户过滤掉了，根本不会给他注册发奖励的任务，自然不会执行。
  别浪费时间研究怎么从Laravel的调度列表里动态删已经注册的任务——本来每次启动都是重新建列表，根本没有存下来的任务给你删，直接在数据源里把无效用户过滤掉，就是成本最低、最不容易出问题的实现方式。

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