应使用 --max-jobs 与 --stop-when-empty 组合、--sleep 参数、queue:listen 替代、redis pub/sub 按需触发或 horizon 自动扩缩容五种方法避免高优队列空转。

如果您在 Laravel 应用中配置了高优先级队列,但发现其持续轮询而无实际任务处理,导致 CPU 占用升高、Redis 连接数激增或数据库连接空闲等待,则可能是由于队列监听器未根据任务存在性动态启停。以下是避免高优队列空转浪费资源的方法:
一、使用 --max-jobs 与 --stop-when-empty 参数组合运行监听器
该方法通过限制单次进程处理任务数量并主动退出空闲状态,使 Supervisor 等进程管理工具可控制重启节奏,避免长时空轮询。
1、修改 Supervisor 的 command 配置项,将原 laravel-worker 改为:php artisan queue:work --queue=high --max-jobs=50 --stop-when-empty。
2、确保 Supervisor 配置中设置了 autostart=true 与 autorestart=true,以便任务耗尽后自动拉起新进程。
3、执行 sudo supervisorctl reread && sudo supervisorctl update 重载配置。
二、启用 --sleep 参数控制空闲间隔
当队列中无任务时,监听器默认立即重试,造成高频空查询;--sleep 参数可强制进程在无任务时挂起指定毫秒数,显著降低轮询频率。
1、在 Supervisor 的 command 中添加 sleep 参数:php artisan queue:work --queue=high --sleep=3000(单位为毫秒,即空闲时等待 3 秒)。
2、若同时需限制内存与运行时长,可追加 --memory=128 --timeout=60 参数防止长期驻留。
3、保存配置后运行 sudo supervisorctl restart laravel-worker: 重启对应进程组。
三、改用 queue:listen 替代 queue:work 并配合信号控制
queue:listen 启动的是短生命周期的子进程,每次取任务前均重建连接,天然规避连接泄漏与空转累积;结合自定义信号处理器可实现更精细的空闲响应逻辑。
1、将 Supervisor command 改为:php artisan queue:listen high --sleep=5000 --timeout=60。
2、在 config/queue.php 的 redis 连接配置中显式设置 'retry_after' => 90,避免因超时误判任务失败而重复入队。
3、确认 Redis 的 notify-keyspace-events 已启用(需在 redis.conf 中设为 Ex),以支持 listen 模式下的事件驱动唤醒。
四、基于 Redis Pub/Sub 实现按需触发监听
该方法完全跳过轮询机制,仅在有高优任务推入时才启动临时监听进程,从架构层面消除空转可能。
1、在 dispatch 高优任务前,执行 Redis::publish('queue:high:ready', '1') 发布就绪信号。
2、编写独立脚本 artisan queue:work-once-high,其逻辑为:订阅 channel、阻塞等待信号、收到后执行一次 php artisan queue:work --queue=high --max-jobs=1 --once、完成后退出。
3、通过 systemd 或 Supervisor 以 oneshot 类型托管该命令,并配置 Restart=no,确保每次触发均为干净进程。
五、配置 Horizon 的 trim-failed 和 auto-scaling 策略
若项目已使用 Laravel Horizon,可通过其内置的资源调控能力自动收缩空闲进程,而非依赖手动配置基础监听器参数。
1、在 config/horizon.php 中定位 'environments' 下对应环境配置块,设置:'high' => ['supervisor-1' => ['minProcesses' => 1, 'maxProcesses' => 4, 'balanceMaxShift' => 1, 'balanceCooldown' => 3]]。
2、启用自动清理策略,在 same 配置段加入:'trim' => ['failed' => 10080, 'recent' => 10080, 'completed' => 10080],防止历史记录拖慢主循环。
3、运行 php artisan horizon:terminate 强制所有 Horizon 主进程在完成当前任务后退出,由守护进程自动按新策略拉起。










