Laravel如何做队列优先级设置_Laravel不同任务分级处理【教程】-Laravel-PHP中文网

Laravel队列优先级靠队列名和独立worker实现，非数值优先级；需为high/default等队列分别启动worker，避免共用进程阻塞；Redis不支持score控优先级，database驱动需加索引并慎用；Horizon的priority仅影响UI排序与auto平衡分配。

laravel如何做队列优先级设置_laravel不同任务分级处理【教程】

队列任务怎么指定优先级

Laravel 本身不支持传统意义上的“优先级数值”（比如 priority=5），它靠的是 queue 名称的调度顺序：先消费哪个队列，哪个队列里的任务就“更优先”。所以真正起作用的是你启动 php artisan queue:work 时指定的队列名顺序。

常见错误是以为加个参数就能提高单个任务的优先级，比如写 dispatch(new Job())->onPriority(10) —— 这根本不存在，Laravel 没这个 API。

用 onQueue('high') 把任务推到 high 队列
另起一个 worker 专门监听 high 队列：php artisan queue:work --queue=high
再起一个 worker 处理默认队列：php artisan queue:work --queue=default
确保 high 队列的 worker 不卡住、不被 kill，否则优先任务照样积压

Redis 驱动下如何避免高优任务被低优任务阻塞

Redis 默认用 list 实现队列（lpush/rpop），但 Laravel 的 redis 驱动实际用的是 sorted set + list 组合，靠 score 控制延迟/重试，**不控制优先级**。也就是说，即使你把 high 队列的任务全塞进 Redis，只要 worker 按 default → high 顺序轮询，还是可能被慢任务拖住。

不要共用一个 worker 进程处理多个队列（如 --queue=high,default），否则一旦 default 里有个耗时 30 秒的任务，high 任务就得等
为每个优先级单独配一个 worker 进程，并用 supervisor 管理，设置 autostart=true 和 startsecs=0
检查 Redis 中实际队列长度：redis-cli llen queues:high，别只看日志以为没积压
如果用 Horizon，它的 supervisor 配置里必须为不同 queue 单独定义 balance 和 processes，不能只靠 balance=auto

数据库驱动下优先级队列的性能隐患

用 database 驱动时，所有队列共享一张 jobs 表，靠 queue 字段区分。这时“优先级”完全依赖查询顺序：where queue in ('high', 'default') order by id asc —— 但 Laravel 默认不是这么查的。

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

真实行为是：worker 每次只取一条，按 id 升序扫表，碰到第一个 queue='high' 就执行；但如果 high 队列前面总插着一堆 default 任务，就会出现“漏扫”或延迟响应。

别在生产环境用 database 驱动做多级优先级，尤其当 QPS > 50
如果非要用，给 jobs.queue 加索引：ALTER TABLE jobs ADD INDEX idx_queue (queue, reserved_at, available_at);
available_at 时间戳比 id 更影响拉取顺序，高优任务务必设 delay(0)，别依赖“先写入就先执行”

Horizon 中 priority 配置的误导点

Horizon 的配置文件里有 priority 数组，例如 'priority' => ['high', 'default']，很多人以为这会让 Horizon 自动提升 high 队列权重。其实它只影响两个地方：一是 Web UI 中队列排序，二是当启用 balance=auto 时，Horizon 会按这个顺序尝试分配 job —— **但前提是所有队列由同一个 supervisor 管理**。

如果你为 high 和 default 各配了独立 supervisor，priority 数组完全不起作用
Horizon 的 metrics 里显示 throughput 是按秒统计的，但高优队列吞吐低，未必是优先级失效，可能是 job 处理逻辑本身慢，得看 runtime 而非 jobs 数
修改 config/horizon.php 后必须执行 php artisan horizon:publish 才能更新 assets，否则 UI 显示的 priority 顺序可能还是旧的