RabbitMQ Docker部署延迟队列需严格匹配插件与服务端版本,手动启用rabbitmq_delayed_message_exchange插件并重启容器,控制台可见x-delayed-message交换类型即成功。

用 Docker 部署 RabbitMQ 延迟队列,核心是装对插件、配对版本、启动到位。3.9+ 版本不再支持通过环境变量自动启用插件,必须手动进容器启用,这点最容易踩坑。
匹配 RabbitMQ 与延迟插件版本
插件不兼容会导致启用失败或功能异常。必须严格按 RabbitMQ 服务端版本选插件:
- 查当前 RabbitMQ 版本:启动容器后执行 docker exec -it myRabbitmq rabbitmqctl version
- 去 GitHub 官方 Releases 页面下载对应版本插件:rabbitmq-delayed-message-exchange
- 例如 RabbitMQ 3.9.22 → 下载 rabbitmq_delayed_message_exchange-3.9.0.ez(注意:3.9.x 系列统一用 3.9.0 插件)
- 3.11 或 3.12 版本需查对应插件 release,不能直接套用旧版
编写并运行 docker-compose.yml
配置重点是挂载插件文件、开启管理界面、设置用户密码,并禁用无效的旧式环境变量。
Docker Hub (hub.docker.com)。此技能适用于所有 Docker Hub 操作,包括读取、创建、更新和删除数据。只要任务涉及 Docker Hub,就使用此技能。
- 确保宿主机目录下已有插件文件,如 ./rabbitmq_delayed_message_exchange-3.9.0.ez
- 不要写 RABBITMQ_PLUGINS=--offline rabbitmq_delayed_message_exchange —— 3.9+ 已废弃,写了也无效
- 正确示例(RabbitMQ 3.9.22):
version: '3'
services:
rabbitmq:
image: rabbitmq:3.9.22-management
container_name: myRabbitmq
ports:
- "5672:5672"
- "15672:15672"
volumes:
- ./rabbitmq_delayed_message_exchange-3.9.0.ez:/plugins/rabbitmq_delayed_message_exchange-3.9.0.ez
environment:
- RABBITMQ_DEFAULT_USER=admin
- RABBITMQ_DEFAULT_PASS=123456
- RABBITMQ_DELAYED_MESSAGE_ENABLED=true # 仅作标识,不自动启用
- 运行:docker-compose up -d
手动启用插件并验证
容器启动后,插件文件已存在,但未激活。必须进入容器执行启用命令。
- 进入容器:docker exec -it myRabbitmq /bin/bash
- 启用插件:rabbitmq-plugins enable rabbitmq_delayed_message_exchange
- 查看状态:rabbitmq-plugins list | grep delayed,看到 [E*] rabbitmq_delayed_message_exchange 即成功
- 退出并重启容器确保持久生效:exit && docker restart myRabbitmq
- 访问 http://localhost:15672,登录后点 “Exchanges” → “Add a new exchange”,Type 下拉框中出现 x-delayed-message 就说明插件就绪
Spring Boot 中使用延迟交换机
代码侧只需定义 CustomExchange 类型为 x-delayed-message,发送时在消息头指定 x-delay(单位毫秒)。
- 配置类中声明交换机:
@Bean
public CustomExchange delayedExchange() {
Map<string object> args = new HashMap();
args.put("x-delayed-type", "direct");
return new CustomExchange("my-delayed-exchange", "x-delayed-message", true, false, args);
}
</string>- 发消息时设置延迟(比如延后 60 秒):
MessageProperties props = new MessageProperties();
props.setHeader("x-delay", 60_000); // 毫秒
Message message = new Message("hello".getBytes(), props);
rabbitTemplate.send("my-delayed-exchange", "routing.key", message);
- 无需额外配置队列 TTL 或死信,插件原生支持高精度延迟投递










