Laravel 队列任务异常处理：正确捕获并邮件通知失败作业

在 laravel 自定义 artisan 命令中调度的队列任务若抛出异常，默认不会触发全局异常 处理器（`appexceptionshandler`），需通过 `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+ 推荐使用）：

 $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() 中抛出 IlluminateQueueMaxAttemptsExceededException，或设置 $tries = 1；
• 确保队列监听器以 –tries 参数运行（例如 php artisan queue:work –tries=3），否则配置可能不生效；
• 对于数据库驱动队列，可配合 php artisan queue:failed 和 php artisan queue:retry all 进行手动排查与重试。

? 进阶提示：你还可以全局监听 IlluminateQueueEventsJobFailed 事件，在 EventServiceProvider 中注册监听器，实现跨任务的统一失败处理策略（如自动创建工单、触发 Webhook 等）。

通过规范使用 failed() 方法，你既能精准捕获各类作业异常，又能解耦业务逻辑与错误通知，构建健壮、可观测的队列系统。