Laravel 10任务调度需手动实现状态可观测性，通过onSuccess/onFailure/before/after钩子记录日志或数据库，结合Cron检查与队列事件监听，覆盖触发、执行、延迟、失败全链路。
Laravel 10 的任务调度本身不内置实时状态面板或数据库记录机制，但可通过组合日志、回调钩子、外部存储和轻量级监控逻辑，实现对任务是否触发、成功、失败、延迟等关键状态的可观测性。核心思路是“主动埋点 + 外部记录 + 异常捕获”，而非依赖调度器自动上报。
在任务定义中添加执行痕迹
每个调度任务都可以通过链式方法注入生命周期钩子，把状态写入日志或数据库表，这是最直接的状态标记方式：
- onSuccess() / onFailure()：分别在任务成功或抛出未捕获异常时触发，适合记录结果和错误堆栈
- before() / after()：在命令真正执行前后调用，可用于打时间戳、记录开始/结束时间、检查前置条件
- sendOutputTo()：将 Artisan 命令的标准输出重定向到指定日志文件，便于排查命令内部行为
示例：记录备份任务的完整生命周期
protected function schedule(Schedule $schedule)
{
$schedule->command('backup:run')
->dailyAt('03:00')
->sendOutputTo(storage_path('logs/backup.log'))
->before(function () {
\Log::info('backup:run started at ' . now());
})
->onSuccess(function () {
\Log::info('backup:run completed successfully');
})
->onFailure(function ($exitCode) {
\Log::error('backup:run failed with exit code: ' . $exitCode);
});
}
用数据库表持久化任务执行记录
创建一张 scheduled_task_logs 表（含字段：task_name、run_at、started_at、finished_at、status、output、error），在 before() 和 onSuccess()/onFailure() 中插入或更新记录。这样可查询某任务最近 10 次是否准时运行、平均耗时、失败率等。
- status 可设为
pending（进入 before）、success、failed - 结合
run_at字段，能识别是否因服务器负载高、schedule:run 被跳过导致“计划了但没执行” - 避免在高频任务（如 everyMinute）中写库造成压力，可改为异步 dispatch 一个日志任务
检查调度器是否被正常触发
调度器本身是否每分钟运行，是所有任务状态的前提。可在服务器 Cron 日志或 Laravel 日志中确认：
- 检查系统 Cron 是否生效：
grep CRON /var/log/syslog或systemctl status cron - 在
schedule:run执行时加简单日志：在 Kernel.php 的 schedule() 方法开头写\Log::debug('schedule:run executed at ' . now()); - 若该日志缺失或间隔远超 1 分钟，说明底层 Cron 失效，所有任务都会“静默丢失”
配合队列任务做延迟与执行状态追踪
若调度任务是分发队列作业（如 $schedule->job(new SendDailyReport)->daily()），则状态监控需延伸至队列层：
- 利用
dispatch()->delay()时记录预期执行时间，与实际 job.finished_at 对比，判断延迟程度 - 监听
JobProcessed和JobFailed事件，在 AppServiceProvider 中注册全局回调，统一入库 - Redis 驱动下可查 ZSET 中延迟任务数量（
zcard queues:delayed），Database 驱动可查jobs表中available_at > now()的条目
