关闭 VIP 通道(高频踩坑点)

一、当前 MQ 服务状态确认 ✅

从执行结果可以确认:

  1. NameServer(127.0.0.1:9876)正常连通
  2. BrokerOMEN已成功注册到集群,地址:192.168.153.1:10911,RocketMQ 5.3.2 服务运行正常
  3. 集群收发 TPS 都是 0,说明当前没有生产、消费消息,属于空闲正常状态

所以MQ 服务本身没有问题,报错Failed to fetch ops home page data是 RocketMQ Dashboard 客户端配置兼容问题。


二、核心解决方案:关闭 VIP 通道(Windows 环境高频坑)

你的日志里 MQ 客户端默认开启了vipChannelEnabled=true,RocketMQ 5.x 在 Windows 本地环境下 VIP 端口极易连接超时,虽然 MQAdmin 实例创建成功,但拉取首页统计数据时接口超时报错。

操作步骤:
  1. 打开application.yml配置文件,新增配置关闭 VIP 通道:

yaml

rocketmq: name-srv-addr: 127.0.0.1:9876 vip-channel-enabled: false
  1. 完全停止当前运行的 RocketMQ Dashboard 进程
  2. 重新执行mvn spring-boot:run启动服务
  3. 刷新前端页面,首页数据即可正常加载

三、备选排查方案(如果关闭 VIP 后仍报错)

  1. 调大 MQ 客户端接口超时时间

yaml

rocketmq: name-srv-addr: 127.0.0.1:9876 vip-channel-enabled: false mq-client-api-timeout: 5000

将超时时间从默认 3000ms 调整为 5000ms,避免查询集群统计数据超时。

  1. 浏览器 F12 查看报错接口 打开开发者工具 - 网络面板,查看首页请求的返回详情:
  • 若为 500 异常:回到后端控制台,查看详细异常堆栈定位具体错误;
  • 若请求正常返回空:只是当前集群没有消息数据,不会再弹出红色报错弹窗。
  1. 开启 Broker 自动创建 Topic 你当前 Broker 已正常运行,可在启动 Broker 时添加参数:

cmd

.\mqbroker.cmd -n 127.0.0.1:9876 autoCreateTopicEnable=true

避免后续在控制台新建 Topic 出现权限异常。