合理配置超时与重试策略可提升 Laravel 队列稳定性。1、通过 $timeout 设置任务最长执行时间；2、使用 --timeout 参数控制监听器超时；3、设置 $delay 实现失败后延迟重试；4、定义 $tries 限制最大重试次数；5、实现 shouldRetry 方法按异常类型决定重试；6、利用 $backoff 配置指数退避重试间隔，避免系统过载。
如果您在使用 Laravel 队列系统时遇到任务执行时间过长或失败的情况，可能是由于任务超时或未设置合理的重试机制。为了确保任务能够稳定执行并具备容错能力，需要对超时和重试策略进行合理配置。
本文运行环境：MacBook Pro，macOS Sonoma
一、设置队列任务的超时时间
通过设置任务的超时时间，可以防止某个任务长时间占用进程导致其他任务阻塞。Laravel 允许在任务类中定义超时属性来控制最大执行时间。
1、打开需要配置的任务类文件，例如 App\Jobs\ProcessPodcast。
2、在类中添加 $timeout 属性，并设置允许的最大执行秒数。
3、示例代码如下：
protected $timeout = 120; // 任务最多运行 120 秒
二、配置队列监听器的超时参数
除了任务级别的超时控制，还可以在启动队列监听器时指定整个工作进程的超时时间，这会影响每个任务处理前的检查周期。
1、在命令行中运行队列监听命令时，使用 --timeout 参数指定单个任务的超时时间。
2、示例命令如下：
php artisan queue:work --timeout=60
3、该值应小于任务自身的 $timeout 值，以确保能被正确终止。
三、设置任务失败后的重试延迟时间
当任务执行失败后，可能希望延迟一段时间再重新尝试，避免因瞬时故障造成连续失败。可以通过定义 $delay 属性实现首次重试前的等待时间。
1、在任务类中添加 $delay 属性。
2、设置延迟秒数，例如：
public $delay = 10; // 失败后等待 10 秒再重试
四、限制任务的最大重试次数
为了避免任务无限次重试消耗资源，应设定最大重试次数。Laravel 提供了多种方式来控制重试次数。
1、在任务类中定义 $tries 属性，指定最大尝试次数。
2、示例代码：
protected $tries = 3; // 最多重试 3 次（含首次执行）
3、或者在调度任务时动态指定：
dispatch((new ProcessPodcast)->onQueue('processing')->delay(now()->addSeconds(5)))->tries(2);
五、基于异常类型自定义重试逻辑
某些情况下，仅当特定异常发生时才需要重试。Laravel 支持通过 shouldRetry 方法实现更精细的控制。
1、在任务类中添加 shouldRetry 方法。
2、编写判断逻辑，返回布尔值决定是否重试。
3、示例代码：
public function shouldRetry($exception): bool
{
return $exception instanceof \Illuminate\Database\QueryException;
}
六、使用指数退避策略控制重试间隔
为避免频繁重试加重系统负担，可采用逐渐增加延迟时间的方式进行重试，即指数退避。
1、在任务类中定义 $backoff 属性。
2、设置一个数组表示每次重试的延迟秒数，或使用整数表示基础延迟倍增。
3、示例代码：
protected $backoff = [1, 5, 10]; // 第一次重试延迟 1 秒，第二次 5 秒，第三次 10 秒
4、也可简写为：
protected $backoff = 5; // 延迟 5, 10, 15... 秒依次递增
