队列任务重复执行主因是超时释放、锁失效或配置偏差；需调高retry_after、启用ShouldBeUnique、配合WithoutOverlapping+Redis锁，并确保驱动与部署环境匹配。
队列任务重复执行，多数不是“真并发冲突”，而是超时释放、锁失效或配置偏差导致的伪重复。关键在理清触发场景，再针对性加固。
检查并调高 retry_after 防止超时误重入
Laravel 默认将执行超过 60 秒的任务视为失败，并自动将其从 reserved 状态移回就绪队列——这会引发同一任务被多次取走执行。Redis 队列驱动中该值硬编码为 $expire = 60，不可忽略。
- 查当前配置：
php artisan tinker --execute="echo config('queue.connections.redis.retry_after');" - 若任务平均耗时约 90 秒，应在
config/queue.php中显式设为'retry_after' => 120 - 同时在任务类中加
protected $timeout = 110;，确保它在超时前主动结束，避免被框架强制中断
启用 ShouldBeUnique 实现参数级去重
对幂等性敏感的任务（如缓存刷新、统计更新），仅靠超时控制不够。Laravel 8.0+ 原生支持基于参数的唯一任务机制。
- 让任务类实现
ShouldBeUnique接口 - 默认按「类名 + 序列化参数」生成唯一键，相同参数的任务入队时自动跳过
- 如需更细粒度控制，可重写
uniqueId()方法，例如返回'update_cache_'.$this->key - 搭配
uniqueFor(300)可限定 5 分钟内同标识任务只保留一个
用 WithoutOverlapping + Redis 锁保障消费端互斥
当多个 worker 同时监听同一队列，或任务本身含状态变更逻辑，需防止同一任务实例被多个进程并发处理。
- 在任务分发时添加中间件：
->middleware([new WithoutOverlapping('task_'.$this->id)]) - 锁键必须带业务上下文，避免全局锁（如只用
'task'）导致串行瓶颈 - 确保所有服务器共用同一个 Redis 实例（非本地文件缓存），否则锁跨节点失效
- 务必设置过期时间：
->expiresAt(now()->addMinutes(5))，防任务崩溃后锁残留
确认队列驱动与部署环境匹配
重复执行常因底层机制错配而放大：
- 使用 database 驱动时，
jobs表的reserved_at字段需被正确更新，否则无法识别“正在执行”状态 - 多服务器部署未启用
onOneServer()或分布式锁，会导致withoutOverlapping()在各节点独立生效 - 部署后未执行
php artisan queue:restart，旧 worker 进程仍运行旧代码，可能绕过新加入的去重逻辑
