在 laravel 自定义 artisan 命令中调度的队列任务若抛出异常，默认不会触发全局异常处理器（`app\exceptions\handler`），需通过 `failed()` 方法显式处理失败作业并发送告警邮件。
在 Laravel 中，队列任务（Job）的异常处理机制与 HTTP 请求生命周期是分离的：即使你在 app/Exceptions/Handler.php 中完善了 render() 或 report() 方法，这些逻辑仅对同步执行的请求或命令生效；而当任务被推送到队列（如 Redis、Database、SQS）并异步执行时，其异常不会经过全局异常处理器，而是由队列系统自身接管。
✅ 正确做法：利用 Laravel 内置的「失败作业处理」机制
首先确保已创建失败作业数据表：
php artisan queue:failed-table php artisan migrate
接着，在你的队列任务类中定义 failed() 方法（注意：该方法接收 Throwable 类型参数，Laravel 8+ 推荐使用）：
<?php
namespace App\Jobs;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Illuminate\Support\Facades\Mail;
use Throwable;
class SendWelcomeEmail implements ShouldQueue
{
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
public function handle()
{
// 模拟可能失败的操作（如第三方 API 调用）
throw new \Exception('SMTP server unreachable');
}
/**
* Called when the job is failed after all retries
*/
public function failed(Throwable $exception)
{
// ✅ 安全可靠：此处可放心执行日志记录、邮件通知、Slack 告警等
\Log::error('Job failed: ' . get_class($this), [
'exception' => $exception->getMessage(),
'trace' => $exception->getTraceAsString(),
'job' => $this,
]);
// 发送定制化告警邮件（建议使用 Mailable + Markdown）
Mail::to('admin@example.com')->send(new JobFailedNotification(
$this::class,
$exception->getMessage(),
$exception->getTraceAsString()
));
}
}? 关键注意事项：
- 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() 方法，你既能精准捕获各类作业异常，又能解耦业务逻辑与错误通知，构建健壮、可观测的队列系统。
