合理配置超时与重试策略可提升 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... 秒依次递增