Laravel 队列任务失败时会自动记录到 failed_jobs 表，需通过 php artisan queue:failed-table 创建表并迁移；任务类中可定义 failed() 方法捕获异常并记录日志或发送通知；使用 php artisan queue:failed 查看失败任务，通过 queue:retry [ID] 或 all 重试；定期用 queue:forget [ID] 删除单个或 queue:flush 清空全部失败任务以避免数据堆积。
如果您在使用 Laravel 队列时遇到任务执行失败的情况，系统会自动将这些任务记录到失败队列中以防止数据丢失。为了确保业务逻辑的完整性和可追溯性，您需要对这些失败任务进行妥善处理。以下是几种常见的处理方式：
本文运行环境：MacBook Pro，macOS Sonoma
一、启用失败任务日志表
Laravel 提供了内置的迁移文件来创建 failed_jobs 表，用于存储执行失败的任务信息。启用该功能后，所有无法成功处理的队列任务都会被持久化保存。
1、运行 Laravel 自带的迁移命令以创建 failed_jobs 数据表：php artisan queue:failed-table。
2、执行数据库迁移更新：php artisan migrate，使数据表结构生效。
二、捕获并记录失败任务
当队列任务抛出未捕获的异常时，Laravel 会自动调用任务类中的 failed() 方法（如果已定义），可用于执行自定义的日志记录或通知操作。
1、在您的队列任务类中添加 failed() 方法，并传入异常对象作为参数。
2、在方法内部编写日志逻辑，例如使用 Laravel 日志组件记录错误详情：Log::error('Queue failed: '.$exception->getMessage());。
3、可在此处触发邮件、钉钉或企业微信通知，提醒开发人员及时排查问题。
三、手动重试失败任务
对于已经进入失败队列的任务，您可以根据需要选择重新推回正常队列进行重试。
1、查看当前所有的失败任务列表：php artisan queue:failed。
2、通过指定 ID 或范围重新发布某个失败任务：php artisan queue:retry [ID]。
3、若要重试所有失败任务，可使用通配符 all：php artisan queue:retry all。
四、清理过期的失败任务
为避免数据库中积累过多无效记录，建议定期清理已确认无法恢复的失败任务。
1、查看所有失败任务并确认是否仍需保留。
2、删除单个失败任务记录：php artisan queue:forget [ID]。
3、清除全部失败任务记录：php artisan queue:flush，此操作不可逆，请谨慎执行。
