队列长度限制必须在声明时设置且不可修改；生产环境推荐用rabbitmqctl set_policy动态配置全局策略，优先级高于客户端参数，匹配队列生效，需避开amq.gen.*临时队列，字段名max-length（无x-前缀），而代码中用x-max-length等带x-前缀参数。
队列长度限制必须在声明队列时设置，创建后无法修改；生产环境推荐用策略（Policy）方式，便于动态调整且不需重启服务或改代码。
怎么用 rabbitmqctl 设置全局策略
策略方式适合批量控制、运维介入或避免硬编码。它对匹配的队列生效，且优先级高于部分客户端参数（实际取最小值）。
-
rabbitmqctl set_policy是唯一支持运行时修改的方式，无需停服 - 正则表达式要避开
amq.gen.*这类自动生成的临时队列，例如：rabbitmqctl set_policy max_len "^(?!amq\.gen).*" '{"max-length": 5000}' --apply-to queues - 若同时设了
max-length和max-length-bytes，任一条件满足即触发溢出 - 策略中的字段名是
max-length（无x-前缀），而代码里要用x-max-length
Java 客户端声明队列时传参
适用于 SpringBoot 或原生 client 场景，但要注意：参数只在首次声明队列时生效；如果队列已存在且参数不同，queueDeclare 会报错。
RabbitMQ 4.2.3
下载
RabbitMQ 4.2.3 是 2026 年初发布的重要稳定更新版本，重点修复了 Khepri 元数据存储相关问题，并改进了监控性能。对于使用 Docker、Kubernetes 或微服务架构的开发团队来说，该版本兼容性和稳定性表现较好。
- 必须用
Map<String, Object>构造arguments，键名带x-前缀："x-max-length"、"x-max-length-bytes"、"x-overflow" -
"x-overflow"可选"drop-head"（默认）或"reject-publish"；后者需开启 publisher confirms，否则生产者收不到basic.nack - 示例：
args.put("x-max-length", 1000); args.put("x-overflow", "drop-head"); - 注意：未确认（unacknowledged）消息不计入长度统计，只算
ready状态的消息数和字节数
Web 管理界面配置的坑
管理界面操作快，但容易忽略两个关键约束：一是仅对新声明队列有效，二是不支持设置 x-overflow —— 它固定为 drop-head。
- 在 “Add a new queue” 页面填 “Max length” 或 “Max length bytes”，值填纯数字（如
1000或10485760） - 填错格式（比如加引号、单位、空格）会导致参数被忽略，队列变成无限制
- 已有队列不能通过 UI 补设长度限制，必须删掉重建（会丢消息！）
- UI 中看不到当前生效的溢出策略，得靠
rabbitmqctl list_queues name messages_ready message_bytes_ready验证
最容易被忽略的是 ready 消息与 unack 消息的区分：长度限制只看 messages_ready，哪怕队列里有 5000 条 unack 消息，只要 ready 是 0，就不会触发溢出。这点在消费者处理慢但没 crash 的场景下，会让长度限制“形同虚设”。
