Laravel Horizon配置调优：maxProcesses、supervisors与queues的关联规则

核心参数的逻辑关联 #

先明确几个参数的核心作用：

• supervisors：每个supervisor是一组worker进程的管理者，负责监听指定队列，将任务分配给下属的worker进程
• maxProcesses：单个supervisor能启动的最大worker进程数
• 队列数量：系统中需要处理的任务队列总数

它们的核心关联是资源分配的粒度与效率：supervisors负责按队列业务类别分组管理worker，maxProcesses控制每组的进程规模，最终所有worker进程的总数必须匹配服务器的CPU、内存承载上限，否则会导致资源耗尽、任务处理效率下降。

针对你的场景：15个Supervisors + 40个队列 + Auto负载均衡 #

关于每个supervisor的maxProcesses最大值，没有固定数值，但必须遵循两个核心限制：

1. CPU资源限制：
   • 若任务是CPU密集型（比如大量计算），总worker进程数建议不超过CPU核心数的1.5-2倍（避免频繁进程切换消耗额外资源）
   • 若任务是IO密集型（比如调用外部API、读写数据库），总worker数可放宽到CPU核心数的3-4倍（worker多数时间在等待IO，多进程能提升资源利用率）
     假设你的服务器是16核CPU，总worker数建议控制在24-64之间，15个supervisors平均下来，单个supervisor的maxProcesses最大值大概在1-4之间，可根据队列任务密度调整——高优先级/高流量队列对应的supervisor可设更高值。
2. 内存资源限制：
   每个Laravel worker进程通常占用50-200MB内存，总内存占用不能超过服务器可用内存的70%（留余量给系统和其他服务）。比如服务器有32GB可用内存，按单worker占100MB算，总worker数最多220个，但实际要结合CPU限制取更严格的那个值。

另外，auto负载均衡模式下，Horizon会自动调整每个supervisor的worker数量（不超过maxProcesses），所以设置maxProcesses时别直接拉满服务器极限，要给Horizon留调整空间。

调优经验法则 #

• Supervisor数量与队列总数的关系：没有硬性规定supervisor数量不能超过队列总数，反而建议按业务类别分组设置supervisor（比如支付队列、通知队列各设一组），方便精细化控制资源。即使多个supervisor监听同一个队列也没问题——适合高并发任务场景，能提升任务处理吞吐量。
• maxProcesses的设置边界：绝对不能只看队列数量，必须绑定服务器硬件：
  • CPU密集型任务：总worker数 ≤ CPU核心数 × 2
  • IO密集型任务：总worker数 ≤ CPU核心数 × 3-4
  • 内存：总worker数 × 单worker平均内存 ≤ 服务器可用内存 × 0.7
• 避免过度拆分supervisor：如果队列数量多但任务量都很小，没必要给每个队列单独设supervisor，按类别合并更高效，减少supervisor本身的资源开销。

参考资料补充 #

虽然官方文档没有直接给出这些经验法则，但可从以下内容推导：

• Laravel Horizon文档中负载均衡章节提到，auto模式核心是基于队列负载动态调整worker，本质是优化资源利用率
• Supervisord官方文档的进程管理最佳实践，强调进程总数不能超过系统资源上限
• Laravel社区实践（如Laracasts论坛、GitHub讨论区）中，大量开发者分享了不同业务场景下的调优案例，可作为参考

内容的提问来源于stack exchange，提问作者Majid Alaeinia