Laravel任务调度防重复需区分调度层与队列层：调度层用withoutOverlapping()配合name()和expiresAt()防并发，多机需onOneServer()；队列层用ShouldBeUnique接口定义uniqueId()和uniqueFor()实现入队唯一性；生产环境还需超时控制与幂等设计。
防止 Laravel 任务调度重复执行，核心是分清「调度层重叠」和「队列层重复」两类问题，对应不同机制。调度层用 withoutOverlapping() 控制同一任务在 schedule:run 周期内的并发；队列层用 ShouldBeUnique 防止相同任务多次入队或并发消费。两者不互斥，常需组合使用。
调度层防重叠：withoutOverlapping()
适用于定时触发的命令或 Job，在 Kernel 的 schedule() 方法中添加，防止上一个实例未结束时新实例被拉起：
- 必须配合
name()使用（尤其对call()闭包），否则报错 “A scheduled event name is required” - 默认锁键基于任务类型+参数生成，可传字符串自定义唯一键，如
withoutOverlapping('cleanup_users') - 锁过期时间默认 1440 秒（24 分钟），可通过
expiresAt()调整，务必大于任务最长可能耗时，否则锁提前失效导致重叠 - 仅作用于当前服务器——多服务器部署时需配合
onOneServer()或外部锁（如 Redis）
队列层防重复：ShouldBeUnique 接口
适用于通过 dispatch() 推送的队列任务，从入队源头控制唯一性，比手动加锁更可靠：
- 实现
ShouldBeUnique接口，框架自动在入队前生成指纹并查缓存 - 重写
uniqueId()定义“哪些算同一个任务”，例如return 'send_welcome_' . $this->userId; - 设置
uniqueFor()控制唯一性窗口（秒），建议按业务容忍范围设，如发券类任务设 300（5 分钟） - 延迟任务（
delay()）同样受控；失败后自动清理指纹，无需手动干预
多服务器与超时兜底策略
单靠框架内置机制还不够，生产环境还需补充：
- 多节点部署时，用
onOneServer()确保调度只在一台机器上运行，避免各节点各自触发 - 对长耗时任务，设置合理超时：调度侧用
runInBackground()->timeout(300)，队列侧调大php artisan queue:work --timeout=600 - 关键任务可叠加 Redis 缓存锁（
Cache::add()+ TTL），作为双重保险，但注意避免与ShouldBeUnique键冲突 - 所有任务设计为幂等：即使意外重复执行，结果状态也一致，不破坏数据一致性
