Ubuntu 上 RabbitMQ 内存与磁盘限制的落地指南
一 核心概念与默认行为
- 内存阈值：默认当节点使用的内存超过40%（vm_memory_high_watermark=0.4）时，会触发流控，阻塞生产者，避免 OOM；达到阈值前会先将消息换页到磁盘以释放内存。
- 磁盘阈值：默认当数据目录所在磁盘可用空间低于50MB时，同样会阻塞生产者并停止内存换页，以降低磁盘被写满的风险。
- 集群影响：在集群中，只要任一节点触发内存或磁盘限制，都会对所有节点的生产者生效（全局流控）。
- 监控频率：磁盘空间至少每10 秒检查一次，接近阈值时可提高到每秒10 次，以避免在两次检查间磁盘被快速写满。
二 持久化配置步骤
- 配置文件路径：编辑 /etc/rabbitmq/rabbitmq.conf（若文件不存在可新建）。
- 内存限制（二选一或混合使用）：
- 相对值：设置节点内存的占用比例，建议范围 0.4–0.7，不建议超过 0.7。示例：
vm_memory_high_watermark.relative = 0.6
- 绝对值：直接限制可用内存上限。示例：
vm_memory_high_watermark.absolute = 2GB
- 内存换页时机：在达到内存上限前开始换页的比例，默认 0.5。示例（在达到上限的 75% 时开始换页）：
vm_memory_high_watermark_paging_ratio = 0.75
- 磁盘限制（二选一）：
- 绝对值：示例（保留至少 1GB 空闲）：
disk_free_limit.absolute = 1GB
- 相对值：示例（保留与物理内存等量的空闲）：
disk_free_limit.relative = 1.0
- 使配置生效：
- 持久化：修改后需重启服务（生产可用滚动重启）。
- 动态（运行时临时调整，重启后失效）：
- 内存阈值：rabbitmqctl set_vm_memory_high_watermark 0.65
- 磁盘阈值：rabbitmqctl set_disk_free_limit 2GB 或 rabbitmqctl set_disk_free_limit mem_relative 1.5
- 备注：生产环境建议将磁盘阈值设置为与物理内存大小相当，以显著降低磁盘写满风险。
三 验证与运维要点
- 查看状态与阈值：
- 节点状态：rabbitmqctl status（关注 memory_limit、disk_free_limit 等字段）
- 连接流控：rabbitmqctl list_connections name state（被阻塞的连接会显示 blocking/blocked 状态）
- 触发效果：当达到内存或磁盘阈值时，生产者会被阻塞；解除后自动恢复。
- 监控建议：启用 rabbitmq_prometheus 插件并抓取 15692/metrics，重点观察：
- rabbitmq_node_mem_used（内存使用率）
- rabbitmq_node_disk_free（磁盘剩余空间）
- rabbitmq_queue_messages（队列积压）
- 日志与告警：关注 /var/log/rabbitmq/rabbit@.log 中的内存/磁盘告警与解除信息。
四 常见注意事项
- 阈值不宜过高：内存阈值超过 0.7 容易在 GC 等场景出现两倍内存的尖峰占用，风险增大。
- 换页并非“禁用流控”：将 vm_memory_high_watermark_paging_ratio 设置为大于 1 仅表示“到达上限前不主动换页”，但达到上限仍会阻塞生产者。
- 集群全局流控：任一节点磁盘告警会导致全集群生产者被阻塞，需优先保障数据目录所在磁盘健康。
- 动态 vs 持久化：命令行动态设置便于应急，重启后失效；生产请在 rabbitmq.conf 中固化并采用滚动重启策略。