Quorum Queue 声明必须设 durable=true 且 arguments 包含 "x-queue-type" => "quorum"；不支持 exclusive/auto_delete，需显式传 false；x-quorum-initial-group-size 应设奇数以保障多数派，x-max-length 与 x-max-length-bytes 需配合使用防 OOM。
声明 Quorum Queue 必须传 x-queue-type 且 durable=true
php-amqplib 不支持像 spring amqp 那样用注解或 builder 封装，所有队列参数都得手动塞进 queue_declare() 的 arguments 数组里。漏掉 "x-queue-type" => "quorum"，rabbitmq 就按 classic 队列处理；更关键的是，durable 参数必须为 true（第 2 个布尔参数），否则服务端直接拒绝创建——quorum queue 强制持久化，不接受 false。
常见错误现象：ChannelException 报错含 NOT_IMPLEMENTED 或 OPERATION_NOT_SUPPORTED，基本就是 RabbitMQ 版本低于 3.8，或没设 durable=true。
-
queue_declare()第 2 个参数是durable，必须传true -
arguments数组里必须包含"x-queue-type" => "quorum" - 不能只靠队列名存在就跳过声明——Quorum Queue 类型变更不会自动生效，必须显式重声明
x-quorum-initial-group-size 控制复制节点数，不是“最大副本数”
这个参数指定仲裁组初始成员数量，比如集群有 5 个节点，但你设 "x-quorum-initial-group-size" => 3，那该队列只会被分配到其中任意 3 个节点上形成 Raft 组（1 leader + 2 followers）。它不是上限，而是“启动时拉起几个节点参与共识”。
为什么建议显式设置？因为不设时默认值是集群总节点数，一旦后续缩容（比如下线 2 个节点），剩余节点数可能跌破多数派（floor(n/2)+1），导致队列不可写。显式设为奇数（如 3 或 5）更可控。
- 值必须 ≤ 当前集群在线节点数，否则声明失败
- 设为 1：退化为单节点持久队列，失去仲裁意义，但可用于测试
- 设为偶数（如 4）理论上可行，但 Raft 多数派要求是
≥3，推荐始终用奇数
内存控制靠 x-max-length 和 x-max-length-bytes，不是“内存配额”
Quorum Queue 没有单独的“内存限制”参数。它优先将消息保留在内存，但当队列堆积超过 x-max-length（条数）或 x-max-length-bytes（字节数）时，会触发溢出策略（x-overflow），把老消息刷到磁盘或丢弃。这本质是间接控内存——避免消息全堆在内存里把节点撑爆。
RabbitMQ 4.2.3 是 2026 年初发布的重要稳定更新版本，重点修复了 Khepri 元数据存储相关问题，并改进了监控性能。对于使用 Docker、Kubernetes 或微服务架构的开发团队来说，该版本兼容性和稳定性表现较好。
容易踩的坑：只设 x-max-length 不设 x-max-length-bytes，遇到大消息（比如带附件的订单）仍可能 OOM；反之亦然。两者建议配合使用。
-
x-overflow推荐设为"drop-head"（默认），避免生产者被阻塞 -
x-max-length值不宜过大，Quorum Queue 写放大明显，10 万条以上易引发磁盘 I/O 压力 - 不要依赖
TTL清理堆积——Quorum Queue 的x-message-ttl支持度有限，部分版本会静默忽略
php-amqplib 声明示例与典型调用顺序
注意：必须先建立连接和 channel，再调用 queue_declare()，且所有参数必须一次性传全。分两次调用（比如先声明再 setArguments）无效。
$channel->queue_declare(
'my.quorum.queue',
true, // durable = true，强制
false, // passive，一般 false
false, // exclusive，Quorum Queue 不支持
false, // auto_delete，Quorum Queue 不支持
[
'x-queue-type' => 'quorum',
'x-quorum-initial-group-size' => 3,
'x-max-length' => 10000,
'x-max-length-bytes' => 104857600, // 100MB
'x-overflow' => 'drop-head'
]
);
真正容易被忽略的是：Quorum Queue 不支持 exclusive 和 auto_delete，这两个参数哪怕传 false 也得显式写出，否则 php-amqplib 可能用默认值（true）导致声明失败。
