Laravel10任务调度如何设置任务告警通知-php教程-PHP中文网

laravel 10任务调度需通过onfailure()回调、日志集成或队列failed()方法实现失败告警；onfailure仅适用于artisan命令，可发邮件/slack/调webhook；全局告警推荐日志通道+外部监控（如sentry）；队列任务可在failed()中按异常类型分类告警，并添加冷却机制与关键信息。

laravel10任务调度如何设置任务告警通知

在 Laravel 10 中，任务调度本身不内置告警通知功能，但可通过 onFailure() 回调、事件监听或日志集成等方式实现可靠的失败告警。关键在于把调度任务的异常捕获与外部通知通道（如邮件、Slack、短信）打通。

使用 onFailure() 直接绑定告警逻辑

这是最直接的方式，适用于单个命令级告警。在 app/Console/Kernel.php 的 schedule() 方法中为任务链式添加 onFailure()：

它接收一个闭包，在任务执行抛出未捕获异常时触发
闭包内可调用通知类、发邮件、写入监控系统或调用 Webhook
注意：该回调只对 Artisan 命令有效，不适用于 call() 或 exec() 类型任务

示例：

protected function schedule(Schedule $schedule)
{
$schedule->command('report:generate')
->dailyAt('06:00')
->onFailure(function () {
\Log::error('每日报告生成失败');
Notification::route('mail', 'ops@example.com')
->notify(new ReportGenerationFailed());
});
}

监听 ScheduleFailed 事件（全局统一处理）

Laravel 10 不直接触发 ScheduleFailed 事件，但可通过日志+外部监控间接实现。更推荐的做法是：利用 Laravel 日志通道将调度错误写入特定文件或通道，再由日志收集器（如 Sentry、Papertrail）自动告警。

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

在 config/logging.php 中为调度任务单独配置 channel，例如 scheduled-tasks
在 onFailure() 中显式使用该 channel 记录错误：Logger::channel('scheduled-tasks')->error(...)
配合 Logstash 或 Sentry 的错误关键词匹配规则，触发邮件/钉钉/Slack 告警

结合队列任务做增强告警（适合复杂调度逻辑）

若调度任务本身是分发队列作业（如 ProcessReportJob::dispatch()），可将告警逻辑下沉到队列任务的 failed() 方法中：

队列任务失败后，Laravel 自动调用其 failed($exception) 方法
此处可精确获取异常类型、堆栈、任务数据，更适合做分类告警（如数据库超时 vs 第三方 API 拒绝）
还能联动清理资源、标记重试状态、更新监控指标

示例：

class ProcessReportJob implements ShouldQueue
{
public function failed($exception)
{
if ($exception instanceof \GuzzleHttp\Exception\ConnectException) {
Notification::route('slack', config('services.slack.webhook_url'))
->notify(new ExternalServiceDown($exception));
}
}
}