在
laravel
自定义 artisan 命令中调度的队列任务若抛出异常，默认不会触发全局异常
处理器
（`app\exceptions\handler`），需通过 `failed()` 方法显式处理失败作业并发送告警邮件。
在 Laravel 中，队列任务（Job）的异常处理机制与 HTTP 请求生命周期是分离的：即使你在 app/Exceptions/Handler.
php
中完善了 render() 或 report() 方法，这些逻辑
仅对同步执行的请求或命令生效
；而当任务被推送到队列（如 Redis、Database、SQS）并异步执行时，其异常
不会经过全局异常处理器
，而是由队列系统自身接管。
✅ 正确做法：利用 Laravel 内置的「失败作业处理」机制
首先确保已创建失败作业数据表：
接着，在你的队列任务类中定义 failed() 方法（注意：该方法接收 Throwable 类型参数，Laravel 8+ 推荐使用）：
? 关键注意事项：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
failed() 方法
仅在任务耗尽所有重试次数后触发
（默认重试 3 次，可通过 --tries=5 或 $tries = 5 属性配置）；
不要在此处 try-catch 异常——这会阻止 Laravel 将其标记为失败，导致 failed() 不被调用；
若需立即失败（不重试），可在 handle() 中抛出 Illuminate\Queue\MaxAttemptsExceededException，或设置 $tries = 1；
确保队列监听器以 --tries 参数运行（例如 php artisan queue:work --tries=3），否则配置可能不生效；
对于数据库驱动队列，可配合 php artisan queue:failed 和 php artisan queue:retry all 进行手动排查与重试。
? 进阶提示：你还可以全局监听 Illuminate\Queue\Events\JobFailed 事件，在 EventServiceProvider 中注册监听器，实现跨任务的统一失败处理策略（如自动创建工单、触发 Webhook 等）。
通过规范使用 failed() 方法，你既能精准捕获各类作业异常，又能解耦业务逻辑与错误通知，构建健壮、可观测的队列系统。
php artisan queue:failed-table
php artisan migrate $exception->getMessage(),
'trace' => $exception->getTraceAsString(),
'job' => $this,
]);
// 发送定制化告警邮件（建议使用 Mailable + Markdown）
Mail::to('admin@example.com')->send(new JobFailedNotification(
$this::class,
$exception->getMessage(),
$exception->getTraceAsString()
));
}
}