Laravel 11任务调度约束通过链式修饰符显式添加，非配置开关：1. withoutOverlapping()防重叠（支持超时自动清理）；2. onOneServer()限单机执行；3. timeout()设最大耗时并触发onFailure；4. environments()按环境启用；5. runInBackground()后台并发执行（不可与withoutOverlapping共用）。
Laravel 11 的任务调度约束不是靠“开关”或配置文件开启的，而是通过链式调用在 schedule() 方法中为每个任务显式添加修饰符。这些修饰符本质是运行前检查逻辑，直接作用于 $schedule->job()、$schedule->command() 或 $schedule->call() 等注册的任务实例。
以下是最常用且生产必需的五类约束及其写法与要点：
withoutOverlapping()：防任务重叠执行
适用于执行时长不确定（比如依赖外部 API、数据库锁竞争）的任务，避免同一任务在上一次未结束时被再次触发。
- Laravel 使用缓存键（默认 Redis）标记任务“正在运行”，下次调度前先检查该键是否存在。
- 可选传入超时秒数，自动清理陈旧锁：
->withoutOverlapping(300)表示 5 分钟后锁自动失效。 - 若使用 database 驱动，需确保
cache和database连接可用；Redis 更推荐，性能高且原子性强。
onOneServer()：限定单服务器执行
多节点部署时（如 Coolify 的集群模式），防止相同任务在所有服务器上同时运行。
- 底层仍依赖缓存（如 Redis）实现分布式锁，只有一台服务器能成功获取锁并执行。
- 必须配合
withoutOverlapping()使用效果更稳，否则锁释放失败可能导致漏执行。 - 注意：该约束不保证“哪台服务器执行”，只保证“仅一台执行”。
timeout()：设置单次执行最大耗时
Laravel 11 原生支持，直接终止卡死任务，防止 worker 被长期占用。
- 写法：
->job(new ProcessData)->daily()->timeout(300) - 超时后任务标记为 failed，可搭配
onFailure()定义告警或补偿逻辑。 - 仅对
job()和command()生效；闭包任务（call()）需自行封装 try-catch + pcntl_alarm 或改用命令封装。
environments()：按环境差异化调度
控制某任务只在特定环境生效，避免开发机误触发生产级操作。
- 写法：
->command('backup:db')->daily()->environments(['production', 'staging']) - 也可排除：
->environments(['!local']) - 实际判断依据是
App::environment()，和.env中的APP_ENV一致。
runInBackground()：后台并发执行（非阻塞）
让耗时任务不阻塞后续调度流程，适合轻量但需异步处理的场景（如日志归档、指标上报）。
- 会 fork 子进程执行，父进程立即返回，不影响其他任务判断。
- 不适用于需要事务一致性或共享内存的逻辑；错误不易捕获，建议配合日志与监控。
- 不能和
withoutOverlapping()同时使用（Laravel 报错），因子进程无法参与主进程的锁管理。
小提醒：所有约束都必须紧跟在任务注册方法之后，且频率方法（如 ->daily()、->everyMinute()）必须存在——Laravel 8+ 起已强制要求，否则任务会被忽略。
