合理设置prefetch_count需兼顾吞吐与稳定性：单进程同步消费设1～5，多进程设10～50，高吞吐轻量场景可试100但须监控内存与ACK延迟；必须配合手动ACK且basic.qos调用须在basic.consume前执行。
消费者预取数（prefetch_count）设多少才不卡顿
预取数不是越大越好，也不是越小越稳。它直接决定消费者一次从RabbitMQ拉多少条消息到本地内存中等待处理；设太高会导致消息堆积在消费者端、OOM或延迟升高；设太低则频繁发basic.qos请求，吞吐量上不去。
典型误判是把prefetch_count当成“并发数”——它控制的是未ACK消息上限，和实际并行处理线程/进程无关。
- 单进程同步消费（如
php think queue:listen）：建议设1～5，避免一条慢任务阻塞后续消息 - 多进程消费者（如
php artisan queue:work --max-jobs=50 --sleep=3配合 supervisor）：可设10～50，平衡网络开销与内存占用 - 高吞吐场景（每秒百级消息）且处理逻辑轻量：可尝试
100，但必须监控消费者内存增长和ACK延迟 - 若使用
php-amqplib手动消费，需显式调用$channel->basic_qos(0, $prefetchCount, false)，且该调用必须在basic_consume前执行
Enqueue 和 php-amqplib 的 prefetch 配置位置差异
两者都依赖 AMQP 协议的 basic.qos，但配置入口完全不同，混用会失效。
Enqueue 的 prefetch_count 是传输层参数，必须在创建连接工厂时传入：
立即学习“PHP免费学习笔记（深入）”；
$connectionFactory = new \Enqueue\AmqpBunny\AmqpConnectionFactory([
'dsn' => 'amqp://guest:guest@localhost:5672/%2f',
'prefetch_count' => 20
]);
而 php-amqplib 的 prefetch_count 是 channel 级配置，且需在声明队列后、开始消费前调用：
$channel->queue_declare('my_queue', false, true, false, false);
$channel->basic_qos(null, 20, false); // 注意第三个参数为 false 表示 global=false
$channel->basic_consume('my_queue', '', false, false, false, false, $callback);
- Enqueue 不支持 per-queue 级别的 qos 覆盖，整个连接共用一个
prefetch_count -
php-amqplib中若漏掉basic_qos()调用，默认值为 0（即无限制），极易导致消费者内存溢出 - 某些旧版
php-amqplib（global=true 支持不完整，务必设false
预取 + 手动 ACK 组合下最容易丢消息的三个操作
启用预取后，必须搭配手动 ACK，否则 RabbitMQ 默认 auto-ack 会立即删除消息——哪怕消费者进程崩溃，消息也找不回来。
- 忘记调用
$channel->basic_ack($deliveryInfo->getDeliveryTag())，尤其在异常分支或 early return 场景 - 在
try/catch中只对成功路径 ack，没在catch里做basic_nack或重试逻辑 - 使用框架封装（如 think-queue）时，误以为
fire()抛异常就自动 nack，实际需确认其是否开启retry_after和max_attempts配置
验证方式：停掉所有消费者，发几条消息，再启一个仅打印不 ack 的消费者，观察管理界面中 Unacked 数是否持续增长——不增长说明根本没进预取队列，可能 qos 没生效或队列声明有误。
为什么改了 prefetch 还是卡在“Ready”状态不动
RabbitMQ 管理界面看到消息长期停留在 Ready（未被拉取）而非 Unacked（已拉取未确认），说明预取配置压根没起作用，常见原因有：
- 消费者代码里没调用
basic_qos()，或调用位置错（比如放在basic_consume()之后） - 队列是惰性声明（lazy queue），但 RabbitMQ 版本
- 使用了镜像队列（ha-all）且节点间同步延迟高，导致 qos 策略未及时广播
- 消费者连接的是 vhost 权限受限的用户，缺少
configure权限，basic_qos请求被静默拒绝
最简验证法：在消费者启动后，立刻执行 rabbitmqctl list_channels，看输出中对应 channel 的 prefetch 列是否显示你设的数值——不显示就是没生效。
