Debian 上 RabbitMQ 版本更新与维护指南
一 准备与版本策略
- 使用官方 APT 仓库获取更新，避免系统自带仓库版本过旧；同时配套添加 Erlang 仓库，确保运行时兼容。Debian 12（Bookworm）示例（amd64）：
- 安装工具与密钥：
- sudo apt-get update && sudo apt-get install -y curl gnupg apt-transport-https
- curl -1sLf “https://keys.openpgp.org/vks/v1/by-fingerprint/0A9AF2115F4687BD29803A206B73A36E6026DFCA” | sudo gpg --dearmor | sudo tee /usr/share/keyrings/com.rabbitmq.team.gpg >/dev/null
- 写入仓库（将 bookworm 替换为你的发行版代号，如 bullseye）：
- echo “deb [arch=amd64 signed-by=/usr/share/keyrings/com.rabbitmq.team.gpg] https://deb1.rabbitmq.com/rabbitmq-erlang/debian bookworm main” | sudo tee /etc/apt/sources.list.d/rabbitmq.list >/dev>
- echo “deb [arch=amd64 signed-by=/usr/share/key.patch] https://deb1.rabbitmq.com/rabbitmq-server/debian bookworm main” | sudo tee -a /etc/apt/sources.list.d/rabbitmq.list >/dev/null
- sudo apt-get update
- 版本兼容要点：
- RabbitMQ 4.0.0+ 要求 Erlang 27.x
- RabbitMQ 3.12.0+ 支持 Erlang 26.x
- RabbitMQ 3.13.0+ 强制要求 Erlang 26.x
- 升级前检查与备份：
- 查看现有版本：rabbitmqctl status；查看可升级版本：apt policy rabbitmq-server
- 备份：元数据 rabbitmqctl export_definitions /path/defs.json；数据目录（默认 /var/lib/rabbitmq）；配置文件（如 rabbitmq.conf、advanced.config）。
二 单机升级步骤
- 就地升级（推荐，保持配置与数据目录不变）：
- 预检：sudo apt-get update && sudo apt-get install -f
- 执行升级：sudo apt-get install --only-upgrade rabbitmq-server
- 重启：sudo systemctl restart rabbitmq-server
- 验证：rabbitmqctl status（检查节点运行与版本）
- 指定版本安装（如需回滚到特定版本）：
- 查询可用版本：apt policy rabbitmq-server
- 安装指定版本：sudo apt-get install rabbitmq-server=
- 重启并验证同上
- 离线或无法连外网时（备选）：
- 下载 .deb：wget https://github.com/rabbitmq/rabbitmq-server/releases/download/vX.Y.Z/rabbitmq-server_X.Y.Z-1_all.deb
- 安装：sudo dpkg -i rabbitmq-server_X.Y.Z-1_all.deb
- 依赖修复：sudo apt-get install -f
- 重启并验证。
三 集群升级策略
- 维护窗口与顺序：选择低峰时段；建议按逐个节点方式升级，先非镜像队列主节点，再镜像队列主节点，最后剩余节点，降低对业务影响。
- 基本流程（每个节点）：
- 检查集群健康：rabbitmqctl cluster_status
- 停止应用（不终止 Erlang 节点）：sudo rabbitmqctl stop_app
- 升级软件包：sudo apt-get install --only-upgrade rabbitmq-server
- 启动应用：sudo rabbitmqctl start_app
- 再次检查：rabbitmqctl cluster_status
- 升级后验证：
- 集群连通性与运行状态：rabbitmqctl cluster_status
- 队列、交换机、绑定与策略一致性：对比升级前后定义或导出定义复核
- 客户端连通性与关键业务场景回归测试。
四 兼容性检查与常见问题
- Erlang 版本匹配：升级 RabbitMQ 前确认目标版本对 Erlang/OTP 的要求（见上），必要时先升级 Erlang 仓库后安装对应 RabbitMQ 版本。
- 插件兼容性：升级后执行 rabbitmq-plugins list，确保已启用插件与目标版本兼容；对不兼容插件先禁用再评估升级或替代方案。
- 元数据存储变更（跨 4.2.0 的重要变更）：
- 4.2.0+ 新集群默认使用 Khepri；既有集群升级后默认仍用 Mnesia。如需迁移，可在升级完成后启用特性标志并逐步迁移：rabbitmqctl enable_feature_flag khepri_db（迁移为渐进式，按官方说明执行并充分验证）。
- AMQP 1.0 durable 默认值（跨 4.2.0 的行为变更）：
- 省略消息头时，durable 默认值改为 false。如业务依赖旧行为，请在客户端显式设置 durable=true，或升级客户端库以匹配新语义。
五 回滚与日常维护
- 回滚方案：
- APT 方式：sudo apt-get install rabbitmq-server=<old_version>；重启并验证
- DEB 方式：保留上一版本安装包，sudo dpkg -i rabbitmq-server_<old_version>.deb；修复依赖并重启
- 日常维护建议：
- 使用官方仓库并定期 apt-get update/upgrade 获取安全补丁
- 重要变更前执行：备份（定义与数据目录）、变更窗口、回滚预案与演练
- 升级后在测试环境或灰度环境充分验证，再推广至生产。
