Laravel(Vapor)如何让任务仅单队列运行？当前实现是否正确？

我在Vapor平台部署了应用，存在一个名为UpdateSomething的长时运行任务，希望该任务仅在单个队列中执行，不允许并发运行。当前编写的任务代码如下：

class UpdateSomething implements ShouldQueue
{
    use Dispatchable;
    use Batchable;
    use InteractsWithQueue;
    use Queueable;
    use SerializesModels;
    
    public $tries = 30;

    /**
     * Create a new job instance.
     */
    public function __construct()
    {
        
    }

    public function middleware(): array
    {
        return [(new WithoutOverlapping(get_class($this)))->releaseAfter(1)];
    }
}

我设置了30次重试次数，每次重试间隔1秒。请问当前的实现方式是否正确？是否需要使用expireAfter？expireAfter的作用是什么？

当前实现的正确性 #

• 核心思路是对的：用WithoutOverlapping中间件，以类名作为锁标识，能确保同一类任务不会同时并发执行。
• 但有个潜在隐患：如果你的长时任务运行时间超过30秒（$tries=30 × releaseAfter(1)），后续的重试任务会耗尽重试次数直接失败。如果任务本身需要运行更久，这个重试逻辑可能不符合预期。

是否需要使用expireAfter #

非常建议加上。因为如果任务在运行过程中意外崩溃（比如Vapor容器被强制回收、进程异常终止），WithoutOverlapping的锁不会被自动释放，后续所有同类型任务都会因为拿不到锁而一直重试直到失败，相当于任务彻底卡住。加上expireAfter就能避免这种死锁情况。

你可以根据任务的实际最长运行时间来设置值，比如任务最多跑5分钟，就设expireAfter(300)。

expireAfter的作用 #

• 它是WithoutOverlapping中间件的配置项，用于设置锁的过期时间（单位：秒）。
• 核心作用是兜底防死锁：当锁的持有时间超过设定值后，不管任务是否正常结束，系统会自动释放锁，确保后续任务可以正常获取锁执行，不会因为之前的任务意外挂掉而永远卡住。

调整后的示例代码：

public function middleware(): array
{
    return [(new WithoutOverlapping(get_class($this)))
        ->releaseAfter(1)
        ->expireAfter(300)]; // 按实际任务最长运行时间调整
}

内容的提问来源于stack exchange，提问作者aceraven777