Windows 11 安装 RabbitMQ 消息队列（完整规范版）

Windows 11 安装 RabbitMQ 消息队列（极简 + 完整步骤）

核心前提：RabbitMQ 依赖Erlang，必须先装 Erlang、再装 RabbitMQ，且版本必须匹配。

一、版本选择（Windows 11 稳定组合）

• Erlang：26.2（64 位）
• RabbitMQ：3.13.0（稳定兼容）
• 安装路径：禁止中文、空格、特殊字符（如D:\Develop\Erlang、D:\Develop\RabbitMQ）

二、第一步：安装 Erlang（必须先装）

2.1 下载

• 官方：https://www.erlang.org/downloads
• 国内镜像（推荐）：https://mirrors.aliyun.com/erlang/otp/
• 下载：otp_win64_26.2.exe

2.2 安装（管理员权限）

1. 右键安装包 →以管理员身份运行
2. 自定义路径：D:\Develop\Erlang
3. 一路 Next → Install → 完成

2.3 配置环境变量（关键）

1. 此电脑 → 右键 → 属性 → 高级系统设置 → 环境变量
2. 系统变量→ 新建：
   • 变量名：ERLANG_HOME
   • 变量值：D:\Develop\Erlang（你的安装根目录）
3. 编辑Path→ 新建：

   plaintext

   %ERLANG_HOME%\bin

4. 保存 → 重启 CMD

2.4 验证

管理员 CMD 执行：

bash

运行

erl -v

出现版本号（如Erlang/OTP 26.2）即成功。

三、第二步：安装 RabbitMQ

3.1 下载

• 官方：https://github.com/rabbitmq/rabbitmq-server/releases
• 下载：rabbitmq-server-3.13.0.exe

3.2 安装（管理员权限）

1. 右键安装包 →以管理员身份运行
2. 自定义路径：D:\Develop\RabbitMQ
3. 一路 Next → Install → 完成（自动注册为 Windows 服务）

3.3 配置环境变量（可选，方便命令行）

1. 编辑Path→ 新建：

   plaintext

   D:\Develop\RabbitMQ\sbin

2. 保存 → 重启 CMD

四、第三步：启动服务 + 开启 Web 管理控制台

4.1 启动 RabbitMQ 服务

管理员 CMD 执行：

bash

运行

# 启动服务 rabbitmq-service start # 停止服务（如需） rabbitmq-service stop # 重启服务 rabbitmq-service restart

4.2 开启 Web 管理插件（可视化界面）

bash

运行

rabbitmq-plugins enable rabbitmq_management

✅ 成功提示：Plugin configuration unchanged.

五、第四步：登录管理控制台

1. 浏览器访问：

   plaintext

   http://localhost:15672

2. 默认账号 / 密码：

   plaintext

   账号：guest 密码：guest

3. 登录成功即可管理队列、交换机、消息等。

六、常用命令（管理员 CMD）

表格

七、常见问题与解决方案

7.1 启动报错：Erlang 未找到

• 原因：版本不匹配 / 环境变量未配置 / 未用管理员权限
• 解决：
  1. 核对版本（Erlang 26.x + RabbitMQ 3.13.x）
  2. 检查ERLANG_HOME和Path配置
  3. 重启电脑，用管理员 CMD 重试

7.2 无法登录管理控制台

• 原因：未开启管理插件 / 端口 15672 被占用
• 解决：
  1. 执行rabbitmq-plugins enable rabbitmq_management
  2. 检查端口：netstat -ano | findstr :15672，杀死占用进程

7.3 服务启动后自动停止（错误 1067）

• 原因：安装路径含中文 / 空格 / 旧数据冲突
• 解决：
  1. 卸载 RabbitMQ，重装到纯英文路径
  2. 删除数据目录：C:\Users\你的用户名\AppData\Roaming\RabbitMQ
  3. 重启电脑后重试

7.4 Java 连接失败

• 原因：服务未启动 / 账号密码错误 / 端口 5672 被占用
• 解决：
  1. 启动服务，确认guest账号可用
  2. 检查 5672 端口：netstat -ano | findstr :5672

八、Spring Boot 快速示例（生产者 + 消费者）

8.1 pom.xml

xml

<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-amqp</artifactId> </dependency> </dependencies>

8.2 application.yml

yaml

spring: rabbitmq: host: 127.0.0.1 port: 5672 username: guest password: guest queue-name: test_queue

8.3 队列配置

java

运行

import org.springframework.amqp.core.Queue; import org.springframework.beans.factory.annotation.Value; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration public class RabbitConfig { @Value("${spring.rabbitmq.queue-name}") private String queueName; @Bean public Queue testQueue() { return new Queue(queueName, true); } }

8.4 生产者

java

运行

import org.springframework.amqp.rabbit.core.RabbitTemplate; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class Producer { @Autowired private RabbitTemplate rabbitTemplate; @Value("${spring.rabbitmq.queue-name}") private String queueName; @GetMapping("/send") public String send() { String msg = "Hello RabbitMQ Win11!"; rabbitTemplate.convertAndSend(queueName, msg); return "发送成功：" + msg; } }

8.5 消费者

java

运行

import org.springframework.amqp.rabbit.annotation.RabbitListener; import org.springframework.stereotype.Component; @Component public class Consumer { @RabbitListener(queues = "${spring.rabbitmq.queue-name}") public void receive(String msg) { System.out.println("收到消息：" + msg); } }

8.6 测试

1. 启动项目
2. 访问：http://localhost:8080/send
3. 控制台打印收到消息，控制台队列同步更新