Spring Cloud Alibaba 消息队列：基于 RocketMQ 实现服务异步通信

痛定思痛。 2022-10-07 11:47 142阅读 0赞

本讲咱们将学习以下三方面内容：

*  介绍消息队列与 Alibaba RocketMQ；
 *  掌握 RocketMQ 的部署方式；
 *  讲解微服务接入 RocketMQ 的开发技巧；

首先咱们先来认识什么是消息队列 MQ 呢？

# 消息队列与 RocketMQ #

## 消息队列 MQ ##

消息队列（Message Queue）简称 MQ，是一种跨进程的通信机制，通常用于应用程序间进行数据的异步传输，MQ 产品在架构中通常也被叫作“消息中间件”。它的最主要职责就是保证服务间进行可靠的数据传输，同时实现服务间的解耦。

这么说太过学术，我们看一个项目的实际案例，假设市级税务系统向省级税务系统上报本年度税务汇总数据，按以往的设计市级税务系统作为数据的生产者需要了解省级税务系统的 IP、端口、接口等诸多细节，然后通过 RPC、RESTful 等方式同步向省级税务系统发送数据，省级税务系统作为数据的消费者接受后响应“数据已接收”。

![系统间跨进程通信][218cf1f0315632ad5188708dc1f4198e.png]

虽然从逻辑上是没有问题的，但是从技术层面却衍生出三个新问题：

*  假如上报时省级税务系统正在升级维护，市级税务系统就必须设计额外的重发机制保证数据的完整性；
 *  假如省级税务系统接收数据需要 1 分钟处理时间，市级税务系统采用同步通信，则市级税务系统传输线程就要阻塞 1 分钟，在高并发场景下如此长时间的阻塞很容易造成系统的崩溃；
 *  假如省级税务系统接口的调用方式、接口、IP、端口有任何改变，都必须立即通知市级税务系统进行调整，否则就会出现通信失败。

从以上三个问题可以看出，省级系统产生的变化直接影响到市级税务系统的执行，两者产生了强耦合，如果问题放在互联网的微服务架构中，几十个服务进行串联调用，每个服务间如果都产生类似的强耦合，系统必然难以维护。

为了解决这种情况，我们需要在架构中部署消息中间件，这个组件应提供可靠的、稳定的、与业务无关的特性，使进程间通信解耦，而这一类消息中间件的代表产品就是 MQ 消息队列。当引入 MQ 消息队列后，消息传递过程会产生以下变化。

![引入 MQ 后通信过程][MQ]

可以看到，引入消息队列后，生产者与消费者都只面向消息队列进行数据处理，数据生产者根本不需要了解具体消费者的信息，只要把数据按事先约定放在指定的队列中即可。而消费者也是一样的，消费者端监听消息队列，如果队列中产生新的数据，MQ 就会通过“**推送 PUSH**”**或者“抽取 PULL**”的方式让消费者获取到新数据进行后续处理。

通过示意图可以看到，只要消息队列产品是稳定可靠的，那消息通信的过程就是有保障的。在架构领域，很多厂商都开发了自己的 MQ 产品，最具代表性的开源产品有：

*  Kafka
 *  ActiveMQ
 *  ZeroMQ
 *  RabbitMQ
 *  RocketMQ

每一种产品都有自己不同的设计与实现原理，但根本的目标都是相同的：为进程间通信提供可靠的异步传输机制。RocketMQ 作为阿里系产品天然被整合进 Spring Cloud Alibaba 生态，在经历过多次双 11 的考验后，RocketMQ 在性能、可靠性、易用性方面都是非常优秀的，下面咱们来了解下 RocketMQ 吧。

# RocketMQ #

RocketMQ 是一款分布式消息队列中间件，官方地址为http://rocketmq.apache.org/，目前最新版本为4.8.0。RocketMQ 最初设计是为了满足阿里巴巴自身业务对异步消息传递的需要，在 3.X 版本后正式开源并捐献给 Apache，目前已孵化为 Apache 顶级项目，同时也是国内使用最广泛、使用人数最多的 MQ 产品之一。

![image-20210617220245353][]

RocketMQ 有很多优秀的特性，在可用性方面，RocketMQ 强调集群无单点，任意一点高可用，客户端具备负载均衡能力，可以轻松实现水平扩容；在性能方面，在天猫双 11 大促背后的亿级消息处理就是通过 RocketMQ 提供的保障；在 API 方面，提供了丰富的功能，可以实现异步消息、同步消息、顺序消息、事务消息等丰富的功能，能满足大多数应用场景；在可靠性方面，提供了消息持久化、失败重试机制、消息查询追溯的功能，进一步为可靠性提供保障。

了解 RocketMQ 的诸多特性后，咱们来理解 RocketMQ 几个重要的概念：

*  消息 Message：消息在广义上就是进程间传递的业务数据，在狭义上不同的 MQ 产品对消息又附加了额外属性如：Topic（主题）、Tags（标签）等；
 *  消息生产者 Producer：指代负责生产数据的角色，在前面案例中市级税务系统就充当了消息生产者的角色；
 *  消息消费者 Consumer：指代使用数据的角色，前面案例的省级税务系统就是消息消费者；
 *  MQ消息服务 Broker：MQ 消息服务器的统称，用于消息存储与消息转发；
 *  生产者组 Producer Group：对于发送同一类消息的生产者，RocketMQ 对其分组，成为生产者组；
 *  消费者组 Consumer Group：对于消费同一类消息的消费者，RocketMQ 对其分组，成为消费者组。

![RocketMQ 组成示意图][RocketMQ]

在理解这些基本概念后，咱们正式进入 RocketMQ 的部署与使用环节，通过案例代码理解 RocketMQ 的执行过程。对于 RocketMQ 来说，使用它需要两个阶段：搭建 RocketMQ 服务器集群与应用接入 RocketMQ 队列，首先咱们来部署 RocketMQ 集群。

# 部署 RocketMQ 集群 #

RocketMQ 天然采用集群模式，常见的 RocketMQ 集群有三种形式：多 Master 模式、多 Master 多 Slave- 异步复制模式、多 Master 多 Slave- 同步双写模式，这三种模式各自的优缺点如下。

*  多 Master 模式是配置最简单的模式，同时也是使用最多的形式。优点是单个 Master 宕机或重启维护对应用无影响，在磁盘配置为 RAID10 时，即使机器宕机不可恢复情况下，由于 RAID10 磁盘非常可靠，同步刷盘消息也不会丢失，性能也是最高的；缺点是单台机器宕机期间，这台机器上未被消费的消息在机器恢复之前不可订阅，消息实时性会受到影响。
 *  多 Master 多 Slave 异步复制模式。每个 Master 配置一个 Slave，有多对 Master-Slave，HA 采用异步复制方式，主备有短暂消息毫秒级延迟，即使磁盘损坏只会丢失少量消息，且消息实时性不会受影响。同时 Master 宕机后，消费者仍然可以从 Slave 消费，而且此过程对应用透明，不需要人工干预，性能同多 Master 模式几乎一样；缺点是 Master 宕机，磁盘损坏情况下会丢失少量消息。
 *  多 Master 多 Slave 同步双写模式，HA 采用同步双写方式，即只有主备都写成功，才向应用返回成功，该模式数据与服务都无单点故障，Master 宕机情况下，消息无延迟，服务可用性与数据可用性都非常高；缺点是性能比异步复制模式低 10% 左右，发送单个消息的执行时间会略高，且目前版本在主节点宕机后，备机不能自动切换为主机。

本讲我们将搭建一个双 Master 服务器集群，首先来看一下部署架构图：

![双 Master 架构图][Master]

在双 Master 架构中，出现了一个新角色 NameServer（命名服务器），NameServer 是 RocketMQ 自带的轻量级路由注册中心，支持 Broker 的动态注册与发现。在 Broker 启动后会自动向 NameServer 发送心跳包，通知 Broker 上线。当 Provider 向 NameServer 获取路由信息，然后向指定 Broker 建立长连接完成数据发送。

### 集群工作流程 ###

*  启动NameServer，NameServer起来后监听端口，等待Broker、Producer、Consumer连上来，相当于一个路由控制中心。
 *  Broker启动，跟所有的NameServer保持长连接，定时发送心跳包。心跳包中包含当前Broker信息(IP+端口等)以及存储所有Topic信息。注册成功后，NameServer集群中就有Topic跟Broker的映射关系。
 *  收发消息前，先创建Topic，创建Topic时需要指定该Topic要存储在哪些Broker上，也可以在发送消息时自动创建Topic。
 *  Producer发送消息，启动时先跟NameServer集群中的其中一台建立长连接，并从NameServer中获取当前发送的Topic存在哪些Broker上，轮询从队列列表中选择一个队列，然后与队列所在的Broker建立长连接从而向Broker发消息。
 *  Consumer跟Producer类似，跟其中一台NameServer建立长连接，获取当前订阅Topic存在哪些Broker上，然后直接跟Broker建立连接通道，开始消费消息。

为了避免单节点瓶颈，通常 NameServer 会部署两台以上作为高可用冗余。NameServer 本身是无状态的，各实例间不进行通信，因此在 Broker 集群配置时要配置所有 NameServer 节点以保证状态同步。

部署 RocketMQ 集群要分两步：部署 NameServer 与部署 Broker 集群。

## 第一步，部署 NameServer 集群。 ##

''我们创建两台 CentOS7 虚拟机，IP 地址分别为 192.168.31.200 与 192.168.31.201，要求这两台虚拟机内存大于 2G，并安装好 64 位 JDK1.8，具体过程不再演示。

之后访问 Apache RocketMQ 下载页：

https://www.apache.org/dyn/closer.cgi?path=rocketmq/4.8.0/rocketmq-all-4.8.0-bin-release.zip

获取 RocketMQ 最新版 rocketmq-all-4.8.0-bin-release.zip，解压后编辑 rocketmq-all-4.8.0-bin-release/bin/runserver.sh 文件，因为 RocketMQ 是服务器软件，默认为其配置 8G 内存，这是 PC 机及或者笔记本吃不消的，所以在 82 行附近将 JVM 内存缩小到 1GB 以方便演示。

修改前：

JAVA_OPT="${JAVA_OPT} -server -Xms8g -Xmx8g -Xmn4g -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"

修改后：

JAVA_OPT="${JAVA_OPT} -server -Xms1g -Xmx1g -Xmn512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"

修改完毕，将 rocketmq-all-4.8.0-bin-release 上传到两台 NameServer 虚拟机的 /usr/local 目录下，执行 bin 目录下的 mqnamesrv 命令。

cd /usr/local/rocketmq-all-4.8.0-bin-release/bin/
    sh mqnamesrv

mqnamesrv 是 RocketMQ 自带 NameServer 的启动命令，执行后看到 `The Name Server boot success. serializeType=JSON` 就代表 NameServer 启动成功，NameServer 将占用 9876 端口提供服务，不要忘记在防火墙设置放行。之后如法炮制在另一台 201 设备上部署 NameServer，构成 NameServer 集群。

## 第二步，部署 Broker 集群。 ##

我们再额外创建两台 CentOS7 虚拟机，IP 地址分别为 192.168.31.210 与 192.168.31.211，同样要求这两台虚拟机内存大于 2G，并安装好 64 位 JDK1.8。

打开 rocketmq-all-4.8.0-bin-release 目录，编辑 /bin/runbroker.sh 文件，同样将启动 Broker 默认占用内存从 8G 缩小到 1G，将 64 行调整为以下内容：

JAVA_OPT="${JAVA_OPT} -server -Xms1g -Xmx1g -Xmn512m"

在 conf 目录下，RocketMQ 已经给我们贴心的准备好三组集群配置模板：

*  2m-2s-async 代表双主双从异步复制模式；
 *  2m-2s-sync 代表双主双从同步双写模式；
 *  2m-noslave 代表双主模式。

![image-20210617221448446][]

我们在 2m-noslave 双主模式目录中，在 broker-a.properties 与 broker-b.properties 末尾追加 NameServer 集群的地址，为了方便理解我也将模板里面每一项的含义进行注释，首先是 broker-a.properties 的完整内容如下：

#集群名称，同一个集群下的 broker 要求统一
    brokerClusterName=DefaultCluster
    #broker 名称
    brokerName=broker-a
    #brokerId=0 代表主节点，大于零代表从节点
    brokerId=0
    #删除日志文件时间点，默认凌晨 4 点
    deleteWhen=04
    #日志文件保留时间，默认 48 小时
    fileReservedTime=48
    #Broker 的角色
    #- ASYNC_MASTER 异步复制Master
    #- SYNC_MASTER 同步双写Master
    brokerRole=ASYNC_MASTER
    #刷盘方式
    #- ASYNC_FLUSH 异步刷盘，性能好宕机会丢数
    #- SYNC_FLUSH 同步刷盘，性能较差不会丢数
    flushDiskType=ASYNC_FLUSH
    #末尾追加，NameServer 节点列表，使用分号分割
    namesrvAddr=192.168.31.200:9876;192.168.31.201:9876

broker-b.properties 只有 brokerName 不同，如下所示：

brokerClusterName=DefaultCluster
    brokerName=broker-b
    brokerId=0
    deleteWhen=04
    fileReservedTime=48
    brokerRole=ASYNC_MASTER
    flushDiskType=ASYNC_FLUSH
    #末尾追加，NameServer 节点列表，使用分号分割
    namesrvAddr=192.168.31.200:9876;192.168.31.201:9876

之后将 rocketmq-all-4.8.0-bin-release 目录上传到 /usr/local 目录，运行下面命令启动 broker 节点 a。

cd /usr/local/rocketmq-all-4.8.0-bin-release/
    sh bin/mqbroker -c ./conf/2m-noslave/broker-a.properties

在 mqbroker 启动命令后增加 c 参数说明要加载哪个 Broker 配置文件。

启动成功会看到下面的日志，Broker 将占用 10911 端口提供服务，请设置防火墙放行。

The broker[broker-a, 192.168.31.210:10911] boot success. serializeType=JSON and name server is 192.168.31.200:9876;192.168.31.201:9876

同样的，在另一台 Master 执行下面命令，启动并加载 broker-b 配置文件。

cd /usr/local/rocketmq-all-4.8.0-bin-release/
    sh bin/mqbroker -c ./conf/2m-noslave/broker-b.properties

到这里 NameServer 集群与 Broker 集群就部署好了，下面执行两个命令验证下。

第一个，使用 mqadmin 命令查看集群状态。

在 bin 目录下存在 mqadmin 命令用于管理 RocketMQ 集群，我们可以使用 clusterList 查看集群节点，命令如下：

sh mqadmin clusterList -n 192.168.31.200:9876

通过查询 NameServer 上的注册信息，得到以下结果。

![Broker 集群信息][Broker]

可以看到在 DefaultCluster 集群中存在两个 Broker，因为 BID 编号为 0，代表它们都是 Master 主节点。

第二个，利用 RocketMQ 自带的 tools.sh 工具通过生成演示数据来测试 MQ 实际的运行情况。在 bin 目录下使用下面命令。

export NAMESRV_ADDR=192.168.31.200:9876
    sh tools.sh org.apache.rocketmq.example.quickstart.Producer

你会看到屏幕输出日志：

SendResult [sendStatus=SEND_OK, msgId=7F0000010B664DC639969F28CF540000, offsetMsgId=C0A81FD200002A9F00000000000413B6, messageQueue=MessageQueue [topic=TopicTest, brokerName=broker-a, queueId=1], queueOffset=0]
    SendResult [sendStatus=SEND_OK, msgId=7F0000010B664DC639969F28CF9B0001, offsetMsgId=C0A81FD200002A9F000000000004147F, messageQueue=MessageQueue [topic=TopicTest, brokerName=broker-a, queueId=2], queueOffset=0]
    SendResult [sendStatus=SEND_OK, msgId=7F0000010B664DC639969F28CFA30002, offsetMsgId=C0A81FD200002A9F0000000000041548, messageQueue=MessageQueue [topic=TopicTest, brokerName=broker-a, queueId=3], queueOffset=0]
    SendResult [sendStatus=SEND_OK, msgId=7F0000010B664DC639969F28CFA70003, offsetMsgId=C0A81FD300002A9F0000000000033C56, messageQueue=MessageQueue [topic=TopicTest, brokerName=broker-b, queueId=0], queueOffset=0]
    SendResult [sendStatus=SEND_OK, msgId=7F0000010B664DC639969F28CFD60004, offsetMsgId=C0A81FD300002A9F0000000000033D1F, messageQueue=MessageQueue [topic=TopicTest, brokerName=broker-b, queueId=1], queueOffset=0]
    SendResult [sendStatus=SEND_OK, msgId=7F0000010B664DC639969F28CFDB0005, offsetMsgId=C0A81FD300002A9F0000000000033DE8, messageQueue=MessageQueue [topic=TopicTest, brokerName=broker-b, queueId=2], queueOffset=0]
    ...

其中broker-a、broker-b 交替出现说明集群生效了。

前面测试的是服务提供者，下面测试消费者，运行下面命令：

export NAMESRV_ADDR=192.168.31.200:9876
    sh tools.sh org.apache.rocketmq.example.quickstart.Consumer

会看到消费者也获取到数据，到这里 RocketMQ 双 Master 集群的搭建就完成了，至于多 Master 多 Slave 的配置也是相似的，大家查阅官方文档相信也能很快上手。

ConsumeMessageThread_11 Receive New Messages: [MessageExt [brokerName=broker-b, queueId=2, storeSize=203, queueOffset=157, sysFlag=0, bornTimestamp=1612100880154, bornHost=/192.168.31.210:54104, storeTimestamp=1612100880159, storeHost=/192.168.31.211:10911, msgId=C0A81FD300002A9F0000000000053509, commitLogOffset=341257, bodyCRC=1116443590, reconsumeTimes=0, preparedTransactionOffset=0, toString()=Message{topic='TopicTest', flag=0, properties={MIN_OFFSET=0, MAX_OFFSET=158, CONSUME_START_TIME=1612100880161, UNIQ_KEY=7F0000010DA64DC639969F2C4B1A0314, CLUSTER=DefaultCluster, WAIT=true, TAGS=TagA}, body=[72, 101, 108, 108, 111, 32, 82, 111, 99, 107, 101, 116, 77, 81, 32, 55, 56, 56], transactionId='null'}]] 
    ConsumeMessageThread_12 Receive New Messages: [MessageExt [brokerName=broker-b, queueId=3, storeSize=203, queueOffset=157, sysFlag=0, bornTimestamp=1612100880161, bornHost=/192.168.31.210:54104, storeTimestamp=1612100880162, storeHost=/192.168.31.211:10911, msgId=C0A81FD300002A9F00000000000535D4, commitLogOffset=341460, bodyCRC=898409296, reconsumeTimes=0, preparedTransactionOffset=0, toString()=Message{topic='TopicTest', flag=0, properties={MIN_OFFSET=0, MAX_OFFSET=158, CONSUME_START_TIME=1612100880164, UNIQ_KEY=7F0000010DA64DC639969F2C4B210315, CLUSTER=DefaultCluster, WAIT=true, TAGS=TagA}, body=[72, 101, 108, 108, 111, 32, 82, 111, 99, 107, 101, 116, 77, 81, 32, 55, 56, 57], transactionId='null'}]]

集群部署好，那如何使用 RocketMQ 进行消息收发呢？我们结合 Spring Boot 代码进行讲解。

### 其他配置 ###

#所属集群名字
    brokerClusterName=rocketmq-cluster
    #broker名字，注意此处不同的配置文件填写的不一样
    brokerName=broker-a
    #0 表示 Master，>0 表示 Slave
    brokerId=0
    #nameServer地址，分号分割
    namesrvAddr=rocketmq-nameserver1:9876;rocketmq-nameserver2:9876
    #在发送消息时，自动创建服务器不存在的topic，默认创建的队列数
    defaultTopicQueueNums=4
    #是否允许 Broker 自动创建Topic，建议线下开启，线上关闭
    autoCreateTopicEnable=true
    #是否允许 Broker 自动创建订阅组，建议线下开启，线上关闭
    autoCreateSubscriptionGroup=true
    #Broker 对外服务的监听端口
    listenPort=10911
    #删除文件时间点，默认凌晨 4点
    deleteWhen=04
    #文件保留时间，默认 48 小时
    fileReservedTime=120
    #commitLog每个文件的大小默认1G
    mapedFileSizeCommitLog=1073741824
    #ConsumeQueue每个文件默认存30W条，根据业务情况调整
    mapedFileSizeConsumeQueue=300000
    #destroyMapedFileIntervalForcibly=120000
    #redeleteHangedFileInterval=120000
    #检测物理文件磁盘空间
    diskMaxUsedSpaceRatio=88
    #存储路径
    storePathRootDir=/usr/local/rocketmq/store
    #commitLog 存储路径
    storePathCommitLog=/usr/local/rocketmq/store/commitlog
    #消费队列存储路径存储路径
    storePathConsumeQueue=/usr/local/rocketmq/store/consumequeue
    #消息索引存储路径
    storePathIndex=/usr/local/rocketmq/store/index
    #checkpoint 文件存储路径
    storeCheckpoint=/usr/local/rocketmq/store/checkpoint
    #abort 文件存储路径
    abortFile=/usr/local/rocketmq/store/abort
    #限制的消息大小
    maxMessageSize=65536
    #flushCommitLogLeastPages=4
    #flushConsumeQueueLeastPages=2
    #flushCommitLogThoroughInterval=10000
    #flushConsumeQueueThoroughInterval=60000
    #Broker 的角色
    #- ASYNC_MASTER 异步复制Master
    #- SYNC_MASTER 同步双写Master
    #- SLAVE
    brokerRole=SYNC_MASTER
    #刷盘方式
    #- ASYNC_FLUSH 异步刷盘
    #- SYNC_FLUSH 同步刷盘
    flushDiskType=SYNC_FLUSH
    #checkTransactionMessageEnable=false
    #发消息线程池数量
    #sendMessageThreadPoolNums=128
    #拉消息线程池数量
    #pullMessageThreadPoolNums=128

# 应用接入 RocketMQ 集群 #

![案例说明][5898f43ce25ac3c0a3f5d585d16ff326.png]

我们以前面的报税为例，利用 Spring Boot 集成 MQ 客户端实现消息收发，首先咱们模拟生产者 Producer。

## 生产者 Producer 发送消息 ##

### 第一步，利用 Spring Initializr 向导创建 rocketmq-provider 工程，确保 pom.xml 引入以下依赖。 ###

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <dependency>
        <groupId>org.apache.rocketmq</groupId>
        <artifactId>rocketmq-client</artifactId>
        <version>4.8.0</version>
    </dependency>

### 第二步，配置应用 application.yml。 ###

rocketmq-client 主要通过编码实现通信，因此无须在 application.yml 做额外配置。

server:
      port: 8000
    spring:
      application:
        name: rocketmq-producer

### 第三步，创建 Controller，生产者发送消息。 ###

@RestController
    public class ProviderController {
        Logger logger = LoggerFactory.getLogger(ProviderController.class);
        @GetMapping(value = "/send_s1_tax")
        public String send1() throws MQClientException {
            //创建DefaultMQProducer消息生产者对象
            DefaultMQProducer producer = new DefaultMQProducer("producer-group");
            //设置NameServer节点地址，多个节点间用分号分割
            producer.setNamesrvAddr("192.168.31.200:9876;192.168.31.201:9876");
            //与NameServer建立长连接
            producer.start();
            try {
                //发送一百条数据
                for(int i = 0 ; i< 100 ; i++) {
                    //数据正文
                    String data = "{\"title\":\"X市2021年度第一季度税务汇总数据\"}";
                    /*创建消息
                        Message消息三个参数
                        topic 代表消息主题，自定义为tax-data-topic说明是税务数据
                        tags 代表标志，用于消费者接收数据时进行数据筛选。2021S1代表2021年第一季度数据
                        body 代表消息内容
                    */
                    Message message = new Message("tax-data-topic", "2021S1", data.getBytes());
                    //发送消息，获取发送结果
                    SendResult result = producer.send(message);
                    //将发送结果对象打印在控制台
                    logger.info("消息已发送：MsgId:" + result.getMsgId() + "，发送状态:" + result.getSendStatus());
                }
            } catch (RemotingException e) {
                e.printStackTrace();
            } catch (MQBrokerException e) {
                e.printStackTrace();
            } catch (InterruptedException e) {
                e.printStackTrace();
            } finally {
                producer.shutdown();
            }
            return "success";
        }
    }

在程序运行后，访问http://localhost:8000/send\_s1\_tax，在控制台会看到如下输出说明数据已被 Broker 接收，Broker 接收后 Producer 端任务已完成。

消息已发送：MsgId:7F00000144E018B4AAC29F3B7B280062，发送状态:SEND_OK
    消息已发送：MsgId:7F00000144E018B4AAC29F3B7B2A0063，发送状态:SEND_OK

下面咱们开发消费者 Consumer。

## 消费者 Consumer 接收消息 ##

### 第一步，利用 Spring Initializr 向导创建 rocketmq-consumer 工程，确保 pom.xml 引入以下依赖。 ###

### 第二步，application.yml 同样无须做额外设置。 ###

server:
      port: 9000
    spring:
      application:
        name: rocketmq-consumer

### 第三步，在应用启动入口 MqConsumerApplication 增加消费者监听代码，关键的代码都已做好注释。 ###

@SpringBootApplication
    public class MqConsumerApplication {
        private static Logger logger = LoggerFactory.getLogger(MqConsumerApplication.class);
        public static void main(String[] args) throws MQClientException {
            SpringApplication.run(MqConsumerApplication.class, args);
            //创建消费者对象
            DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("consumer-group");
            //设置NameServer节点
            consumer.setNamesrvAddr("192.168.31.200:9876;192.168.31.201:9876");
            /*订阅主题，
            consumer.subscribe包含两个参数：
            topic: 说明消费者从Broker订阅哪一个主题，这一项要与Provider保持一致。
            subExpression: 子表达式用于筛选tags。
                同一个主题下可以包含很多不同的tags，subExpression用于筛选符合条件的tags进行接收。
                例如：设置为*，则代表接收所有tags数据。
                例如：设置为2020S1，则Broker中只有tags=2020S1的消息会被接收，而2020S2就会被排除在外。
            */
            consumer.subscribe("tax-data-topic", "*");
            //创建监听，当有新的消息监听程序会及时捕捉并加以处理。
            consumer.registerMessageListener(new MessageListenerConcurrently() {
                public ConsumeConcurrentlyStatus consumeMessage(
                        List<MessageExt> msgs, ConsumeConcurrentlyContext context) {
                    //批量数据处理
                    for (MessageExt msg : msgs) {
                        logger.info("消费者消费数据:"+new String(msg.getBody()));
                    }
                    //返回数据已接收标识
                    return ConsumeConcurrentlyStatus.CONSUME_SUCCESS;
                }
            });
            //启动消费者，与Broker建立长连接，开始监听。
            consumer.start();
        }
    }

当应用启动后，Provider 产生新消息的同时，Consumer 端就会立即消费掉，控制台产生输出。

2021-01-31 22:25:14.212  INFO 17328 --- [MessageThread_3] c.l.r.MqConsumerApplication        : 消费者消费数据:{"title":"X市2021年度第一季度税务汇总数据"}
    2021-01-31 22:25:14.217  INFO 17328 --- [MessageThread_2] c.l.r.MqConsumerApplication        : 消费者消费数据:{"title":"X市2021年度第一季度税务汇总数据"}

以上便是 Spring Boot 接入 RocketMQ 集群的过程。对于当前的案例我们是通过代码方式控制消息收发，在 Spring Cloud 生态中还提供了 Spring Cloud Stream 模块，允许程序员采用“声明式”的开发方式实现与 MQ 更轻松的接入，但 Spring Cloud Stream 本身封装度太高，很多 RocketMQ 的细节也被隐藏了，这对于入门来说并不是一件好事。在掌握 RocketMQ 的相关内容后再去学习 Spring Cloud Stream 你会理解得更加透彻。

# mqadmin管理工具 #

## 使用方式 ##

进入RocketMQ安装位置，在bin目录下执行`./mqadmin {command} {args}`

### 命令介绍 ###

#### 1 ）Topic相关 ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>含义</th> 
   <th>命令选项</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>updateTopic</td> 
   <td>创建更新Topic配置</td> 
   <td>-b</td> 
   <td>Broker 地址，表示 topic 所在 Broker，只支持单台Broker，地址为ip:port</td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>cluster 名称，表示 topic 所在集群（集群可通过 clusterList 查询）</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h-</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-p</td> 
   <td>指定新topic的读写权限( W=2|R=4|WR=6 )</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-r</td> 
   <td>可读队列数（默认为 8）</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-w</td> 
   <td>可写队列数（默认为 8）</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic 名称（名称只能使用字符 <sup><a rel="nofollow">1</a></sup>+$ ）</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>deleteTopic</td> 
   <td>删除Topic</td> 
   <td>-c</td> 
   <td>cluster 名称，表示删除某集群下的某个 topic （集群 可通过 clusterList 查询）</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic 名称（名称只能使用字符 <sup><a rel="nofollow">2</a></sup>+$ ）</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>topicList</td> 
   <td>查看 Topic 列表信息</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>不配置-c只返回topic列表，增加-c返回clusterName, topic, consumerGroup信息，即topic的所属集群和订阅关系，没有参数</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>topicRoute</td> 
   <td>查看 Topic 路由信息</td> 
   <td>-t</td> 
   <td>topic 名称</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>topicStatus</td> 
   <td>查看 Topic 消息队列offset</td> 
   <td>-t</td> 
   <td>topic 名称</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>topicClusterList</td> 
   <td>查看 Topic 所在集群列表</td> 
   <td>-t</td> 
   <td>topic 名称</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>updateTopicPerm</td> 
   <td>更新 Topic 读写权限</td> 
   <td>-t</td> 
   <td>topic 名称</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-b</td> 
   <td>Broker 地址，表示 topic 所在 Broker，只支持单台Broker，地址为ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-p</td> 
   <td>指定新 topic 的读写权限( W=2|R=4|WR=6 )</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>cluster 名称，表示 topic 所在集群（集群可通过 clusterList 查询），-b优先，如果没有-b，则对集群中所有Broker执行命令</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>updateOrderConf</td> 
   <td>从NameServer上创建、删除、获取特定命名空间的kv配置，目前还未启用</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic，键</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-v</td> 
   <td>orderConf，值</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-m</td> 
   <td>method，可选get、put、delete</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>allocateMQ</td> 
   <td>以平均负载算法计算消费者列表负载消息队列的负载结果</td> 
   <td>-t</td> 
   <td>topic 名称</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>ipList，用逗号分隔，计算这些ip去负载Topic的消息队列</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>statsAll</td> 
   <td>打印Topic订阅关系、TPS、积累量、24h读写总量等信息</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-a</td> 
   <td>是否只打印活跃topic</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>指定topic</td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

#### 2）集群相关 ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>含义</th> 
   <th>命令选项</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>clusterList</td> 
   <td>查看集群信息，集群、BrokerName、BrokerId、TPS等信息</td> 
   <td>-m</td> 
   <td>打印更多信息 (增加打印出如下信息 #InTotalYest, #OutTotalYest, #InTotalToday ,#OutTotalToday)</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>打印间隔，单位秒</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>clusterRT</td> 
   <td>发送消息检测集群各Broker RT。消息发往${BrokerName} Topic。</td> 
   <td>-a</td> 
   <td>amount，每次探测的总数，RT = 总时间 / amount</td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>消息大小，单位B</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>探测哪个集群</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-p</td> 
   <td>是否打印格式化日志，以|分割，默认不打印</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-m</td> 
   <td>所属机房，打印使用</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>发送间隔，单位秒</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

#### 3）Broker相关 ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>含义</th> 
   <th>命令选项</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>updateBrokerConfig</td> 
   <td>更新 Broker 配置文件，会修改Broker.conf</td> 
   <td>-b</td> 
   <td>Broker 地址，格式为ip:port</td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>cluster 名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-k</td> 
   <td>key 值</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-v</td> 
   <td>value 值</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>brokerStatus</td> 
   <td>查看 Broker 统计信息、运行状态（你想要的信息几乎都在里面）</td> 
   <td>-b</td> 
   <td>Broker 地址，地址为ip:port</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>brokerConsumeStats</td> 
   <td>Broker中各个消费者的消费情况，按Message Queue维度返回Consume Offset，Broker Offset，Diff，TImestamp等信息</td> 
   <td>-b</td> 
   <td>Broker 地址，地址为ip:port</td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>请求超时时间</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-l</td> 
   <td>diff阈值，超过阈值才打印</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-o</td> 
   <td>是否为顺序topic，一般为false</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>getBrokerConfig</td> 
   <td>获取Broker配置</td> 
   <td>-b</td> 
   <td>Broker 地址，地址为ip:port</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>wipeWritePerm</td> 
   <td>从NameServer上清除 Broker写权限</td> 
   <td>-b</td> 
   <td>Broker 地址，地址为ip:port</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cleanExpiredCQ</td> 
   <td>清理Broker上过期的Consume Queue，如果手动减少对列数可能产生过期队列</td> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-b</td> 
   <td>Broker 地址，地址为ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>集群名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cleanUnusedTopic</td> 
   <td>清理Broker上不使用的Topic，从内存中释放Topic的Consume Queue，如果手动删除Topic会产生不使用的Topic</td> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-b</td> 
   <td>Broker 地址，地址为ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>集群名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>sendMsgStatus</td> 
   <td>向Broker发消息，返回发送状态和RT</td> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-b</td> 
   <td>BrokerName，注意不同于Broker地址</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>消息大小，单位B</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>发送次数</td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

#### 4）消息相关 ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>含义</th> 
   <th>命令选项</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>queryMsgById</td> 
   <td>根据offsetMsgId查询msg，如果使用开源控制台，应使用offsetMsgId，此命令还有其他参数，具体作用请阅读QueryMsgByIdSubCommand。</td> 
   <td>-i</td> 
   <td>msgId</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>queryMsgByKey</td> 
   <td>根据消息 Key 查询消息</td> 
   <td>-k</td> 
   <td>msgKey</td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>Topic 名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>queryMsgByOffset</td> 
   <td>根据 Offset 查询消息</td> 
   <td>-b</td> 
   <td>Broker 名称，（这里需要注意 填写的是 Broker 的名称，不是 Broker 的地址，Broker 名称可以在 clusterList 查到）</td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>query 队列 id</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-o</td> 
   <td>offset 值</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic 名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>queryMsgByUniqueKey</td> 
   <td>根据msgId查询，msgId不同于offsetMsgId，区别详见常见运维问题。-g，-d配合使用，查到消息后尝试让特定的消费者消费消息并返回消费结果</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>uniqe msg id</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-g</td> 
   <td>consumerGroup</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-d</td> 
   <td>clientId</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>checkMsgSendRT</td> 
   <td>检测向topic发消息的RT，功能类似clusterRT</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-a</td> 
   <td>探测次数</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>消息大小</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>sendMessage</td> 
   <td>发送一条消息，可以根据配置发往特定Message Queue，或普通发送。</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-p</td> 
   <td>body，消息体</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-k</td> 
   <td>keys</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>tags</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-b</td> 
   <td>BrokerName</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>queueId</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>consumeMessage</td> 
   <td>消费消息。可以根据offset、开始&amp;结束时间戳、消息队列消费消息，配置不同执行不同消费逻辑，详见ConsumeMessageCommand。</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-b</td> 
   <td>BrokerName</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-o</td> 
   <td>从offset开始消费</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>queueId</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-g</td> 
   <td>消费者分组</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>开始时间戳，格式详见-h</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-d</td> 
   <td>结束时间戳</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>消费多少条消息</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>printMsg</td> 
   <td>从Broker消费消息并打印，可选时间段</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>字符集，例如UTF-8</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>subExpress，过滤表达式</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-b</td> 
   <td>开始时间戳，格式参见-h</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-e</td> 
   <td>结束时间戳</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-d</td> 
   <td>是否打印消息体</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>printMsgByQueue</td> 
   <td>类似printMsg，但指定Message Queue</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>queueId</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-a</td> 
   <td>BrokerName</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>字符集，例如UTF-8</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>subExpress，过滤表达式</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-b</td> 
   <td>开始时间戳，格式参见-h</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-e</td> 
   <td>结束时间戳</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-p</td> 
   <td>是否打印消息</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-d</td> 
   <td>是否打印消息体</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-f</td> 
   <td>是否统计tag数量并打印</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>resetOffsetByTime</td> 
   <td>按时间戳重置offset，Broker和consumer都会重置</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-g</td> 
   <td>消费者分组</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>重置为此时间戳对应的offset</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-f</td> 
   <td>是否强制重置，如果false，只支持回溯offset，如果true，不管时间戳对应offset与consumeOffset关系</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>是否重置c++客户端offset</td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

#### 5）消费者、消费组相关 ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>含义</th> 
   <th>命令选项</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>consumerProgress</td> 
   <td>查看订阅组消费状态，可以查看具体的client IP的消息积累量</td> 
   <td>-g</td> 
   <td>消费者所属组名</td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>是否打印client IP</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>consumerStatus</td> 
   <td>查看消费者状态，包括同一个分组中是否都是相同的订阅，分析Process Queue是否堆积，返回消费者jstack结果，内容较多，使用者参见ConsumerStatusSubCommand</td> 
   <td>-h</td> 
   <td>打印帮助</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-g</td> 
   <td>consumer group</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>clientId</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>是否执行jstack</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>getConsumerStatus</td> 
   <td>获取 Consumer 消费进度</td> 
   <td>-g</td> 
   <td>消费者所属组名</td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>查询主题</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>Consumer 客户端 ip</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>updateSubGroup</td> 
   <td>更新或创建订阅关系</td> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-b</td> 
   <td>Broker地址</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>集群名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-g</td> 
   <td>消费者分组名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>分组是否允许消费</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-m</td> 
   <td>是否从最小offset开始消费</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-d</td> 
   <td>是否是广播模式</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-q</td> 
   <td>重试队列数量</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-r</td> 
   <td>最大重试次数</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-i</td> 
   <td>当slaveReadEnable开启时有效，且还未达到从slave消费时建议从哪个BrokerId消费，可以配置备机id，主动从备机消费</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-w</td> 
   <td>如果Broker建议从slave消费，配置决定从哪个slave消费，配置BrokerId，例如1</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-a</td> 
   <td>当消费者数量变化时是否通知其他消费者负载均衡</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>deleteSubGroup</td> 
   <td>从Broker删除订阅关系</td> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-b</td> 
   <td>Broker地址</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-c</td> 
   <td>集群名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-g</td> 
   <td>消费者分组名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cloneGroupOffset</td> 
   <td>在目标群组中使用源群组的offset</td> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-s</td> 
   <td>源消费者组</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-d</td> 
   <td>目标消费者组</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>topic名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-o</td> 
   <td>暂未使用</td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

#### 6）连接相关 ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>含义</th> 
   <th>命令选项</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>consumerConnec tion</td> 
   <td>查询 Consumer 的网络连接</td> 
   <td>-g</td> 
   <td>消费者所属组名</td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>producerConnec tion</td> 
   <td>查询 Producer 的网络连接</td> 
   <td>-g</td> 
   <td>生产者所属组名</td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td>主题名称</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

#### 7）NameServer相关 ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>含义</th> 
   <th>命令选项</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>updateKvConfig</td> 
   <td>更新NameServer的kv配置，目前还未使用</td> 
   <td>-s</td> 
   <td>命名空间</td> 
  </tr> 
  <tr> 
   <td>-k</td> 
   <td>key</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-v</td> 
   <td>value</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>deleteKvConfig</td> 
   <td>删除NameServer的kv配置</td> 
   <td>-s</td> 
   <td>命名空间</td> 
  </tr> 
  <tr> 
   <td>-k</td> 
   <td>key</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>getNamesrvConfig</td> 
   <td>获取NameServer配置</td> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>updateNamesrvConfig</td> 
   <td>修改NameServer配置</td> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-k</td> 
   <td>key</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>-v</td> 
   <td>value</td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

#### 8）其他 ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>含义</th> 
   <th>命令选项</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>startMonitoring</td> 
   <td>开启监控进程，监控消息误删、重试队列消息数等</td> 
   <td>-n</td> 
   <td>NameServer 服务地址，格式 ip:port</td> 
  </tr> 
  <tr> 
   <td>-h</td> 
   <td>打印帮助</td> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

## 注意事项 ##

*  几乎所有命令都需要配置-n表示NameServer地址，格式为ip:port
 *  几乎所有命令都可以通过-h获取帮助
 *  如果既有Broker地址（-b）配置项又有clusterName（-c）配置项，则优先以Broker地址执行命令；如果不配置Broker地址，则对集群中所有主机执行命令

# 小结 #

本讲咱们学习了三方面内容，首先介绍了什么是 MQ 以及 Alibaba RocketMQ 的特性；其次详细讲解了 RocketMQ 双主集群的部署过程；最后通过 Spring Boot 应用中引入 RocketMQ-Client 实现消息的收发。

这里为你留一道思考题：目前主流的 MQ 产品有 RocketMQ、RabbitMQ、Kafka、ActiveMQ、ZeroMQ……不同的产品有不同的设计，假设在银行的金融交易基于 MQ 实现，对 MQ 的可靠性与一致性要求较高，但对数据的响应时间不敏感。如果你是架构师该如何选型，欢迎你把自己的思考写在评论区和大家一起分享。

# 参考 #

https://blog.csdn.net/qq\_35190492/article/details/103341634

--------------------

1.  a-zA-Z0-9\_- ↩︎
2.  a-zA-Z0-9\_- ↩︎

[218cf1f0315632ad5188708dc1f4198e.png]: /images/20221005/a3f77c6b8faa4679af36537074322c4e.png
[MQ]: /images/20221005/8f3f3f93dd4a4985b6ccb8971cdf5757.png
[image-20210617220245353]: /images/20221005/09f4ed12fd3f434d851b0361456ef25e.png
[RocketMQ]: /images/20221005/8cb98064566b4cc5b756dca3bf2bb951.png
[Master]: /images/20221005/4eda446c88924dc0b0b53971da66648f.png
[image-20210617221448446]: /images/20221005/633e863e10e345ec80736c727b7b1aac.png
[Broker]: /images/20221005/93ac9f8515a247fb90bf860075fefca2.png
[5898f43ce25ac3c0a3f5d585d16ff326.png]: /images/20221005/65305f87ee3d4fb8b0d99ba4579cf242.png