RocketMQ 核心特性实战详解

🚩RocketMQ 核心特性实战详解

本文基于 RocketMQ 4.x + rocketmq-spring-boot-starter 2.3.1，从零搭建，逐步讲解 RocketMQ 11大核心特性，每一段代码都能直接跑。

---

0. 项目环境准备

依赖引入

在 pom.xml 文件添加：

<dependency>
    <groupId>org.apache.rocketmq</groupId>
    <artifactId>rocketmq-spring-boot-starter</artifactId>
    <version>2.3.1</version>
</dependency>

配置文件 application.yml

server:
  port: 8080

spring:
  rocketmq:
    name-server: 127.0.0.1:9876 # RocketMQ NameServer 地址
    producer:
      group: demo-producer-group # 默认生产者组
    consumer:
      group: demo-consumer-group # 默认消费者组

本地启动 RocketMQ 可以使用 Docker，示例见文末。

---

1. 普通消息（Standard Message）

应用场景

• 注册成功后，发送欢迎短信/邮件通知。

完整代码

1.1 生产者

package com.example.rocketmq.producer;

import org.apache.rocketmq.spring.core.RocketMQTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.messaging.support.MessageBuilder;
import org.springframework.stereotype.Service;

@Service
public class StandardMessageProducer {

    @Autowired
    private RocketMQTemplate rocketMQTemplate;

    /**
     * 发送普通消息
     * @param topic 消息主题
     * @param message 消息内容
     */
    public void send(String topic, String message) {
        rocketMQTemplate.send(topic, MessageBuilder.withPayload(message).build());
    }
}

1.2 消费者

package com.example.rocketmq.consumer;

import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.springframework.stereotype.Service;

/**
 * 普通消息消费者
 */
@Service
@RocketMQMessageListener(topic = "register-topic", consumerGroup = "register-consumer-group")
public class StandardMessageConsumer implements RocketMQListener<String> {

    @Override
    public void onMessage(String message) {
        System.out.println("【普通消息】收到消息：" + message);
    }
}

1.3 Controller 测试入口

package com.example.rocketmq.controller;

import com.example.rocketmq.producer.StandardMessageProducer;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/standard")
public class StandardMessageController {

    @Autowired
    private StandardMessageProducer producer;

    @PostMapping("/send")
    public String sendMessage(@RequestParam String message) {
        producer.send("register-topic", message);
        return "普通消息发送成功";
    }
}

---

2. 定时/延时消息（Delayed Message）

应用场景

• 下单 30分钟未支付，自动取消订单。

完整代码

2.1 生产者

package com.example.rocketmq.producer;

import org.apache.rocketmq.spring.core.RocketMQTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.messaging.support.MessageBuilder;
import org.springframework.stereotype.Service;

@Service
public class DelayedMessageProducer {

    @Autowired
    private RocketMQTemplate rocketMQTemplate;

    /**
     * 发送延时消息
     * @param topic 消息主题
     * @param message 消息内容
     * @param delayLevel 延迟等级
     */
    public void send(String topic, String message, int delayLevel) {
        rocketMQTemplate.syncSend(topic, MessageBuilder.withPayload(message).build(), 3000, delayLevel);
    }
}

2.2 消费者

package com.example.rocketmq.consumer;

import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.springframework.stereotype.Service;

/**
 * 延迟消息消费者
 */
@Service
@RocketMQMessageListener(topic = "order-cancel-topic", consumerGroup = "delay-consumer-group")
public class DelayedMessageConsumer implements RocketMQListener<String> {

    @Override
    public void onMessage(String message) {
        System.out.println("【延迟消息】收到消息：" + message);
    }
}

2.3 Controller 测试入口

package com.example.rocketmq.controller;

import com.example.rocketmq.producer.DelayedMessageProducer;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/delay")
public class DelayedMessageController {

    @Autowired
    private DelayedMessageProducer producer;

    @PostMapping("/send")
    public String sendDelayMessage(@RequestParam String message, @RequestParam int delayLevel) {
        producer.send("order-cancel-topic", message, delayLevel);
        return "延迟消息发送成功";
    }
}

🚨注意：RocketMQ 支持固定的延迟等级，不支持任意延迟。

---

3. 顺序消息（Ordered Message）

应用场景

• 订单生命周期：下单 → 支付 → 发货，顺序执行。

完整代码

3.1 生产者

package com.example.rocketmq.producer;

import org.apache.rocketmq.spring.core.RocketMQTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class OrderedMessageProducer {

    @Autowired
    private RocketMQTemplate rocketMQTemplate;

    /**
     * 发送顺序消息
     * @param topic 消息主题
     * @param message 消息内容
     * @param hashKey 用于分区的 key
     */
    public void send(String topic, String message, String hashKey) {
        rocketMQTemplate.syncSendOrderly(topic, message, hashKey);
    }
}

3.2 消费者

package com.example.rocketmq.consumer;

import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.springframework.stereotype.Service;

/**
 * 顺序消息消费者
 */
@Service
@RocketMQMessageListener(topic = "order-topic", consumerGroup = "order-consumer-group")
public class OrderedMessageConsumer implements RocketMQListener<String> {

    @Override
    public void onMessage(String message) {
        System.out.println("【顺序消息】收到消息：" + message);
    }
}

3.3 Controller 测试入口

package com.example.rocketmq.controller;

import com.example.rocketmq.producer.OrderedMessageProducer;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/order")
public class OrderedMessageController {

    @Autowired
    private OrderedMessageProducer producer;

    @PostMapping("/send")
    public String sendOrderedMessage(@RequestParam String message, @RequestParam String hashKey) {
        producer.send("order-topic", message, hashKey);
        return "顺序消息发送成功";
    }
}

---

4. 事务消息（Transactional Message）

应用场景

• 分布式事务，订单保存和库存扣减一致性控制。

完整代码

4.1 生产者

package com.example.rocketmq.producer;

import org.apache.rocketmq.spring.core.RocketMQTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.messaging.Message;
import org.springframework.messaging.support.MessageBuilder;
import org.springframework.stereotype.Service;

@Service
public class TransactionalMessageProducer {

    @Autowired
    private RocketMQTemplate rocketMQTemplate;

    /**
     * 发送事务消息
     * @param topic 消息主题
     * @param message 消息内容
     */
    public void send(String topic, String message) {
        Message<String> msg = MessageBuilder.withPayload(message).build();
        rocketMQTemplate.sendMessageInTransaction(topic, msg, null);
    }
}

4.2 事务监听器

package com.example.rocketmq.listener;

import org.apache.rocketmq.spring.annotation.RocketMQTransactionListener;
import org.apache.rocketmq.spring.core.RocketMQLocalTransactionListener;
import org.apache.rocketmq.spring.core.RocketMQLocalTransactionState;
import org.springframework.messaging.Message;
import org.springframework.stereotype.Component;

/**
 * 事务消息监听器
 */
@Component
@RocketMQTransactionListener(txProducerGroup = "demo-producer-group")
public class TransactionListenerImpl implements RocketMQLocalTransactionListener {

    @Override
    public RocketMQLocalTransactionState executeLocalTransaction(Message message, Object o) {
        // 执行本地事务
        System.out.println("执行本地事务：" + message.getPayload());
        // 这里模拟成功提交
        return RocketMQLocalTransactionState.COMMIT;
    }

    @Override
    public RocketMQLocalTransactionState checkLocalTransaction(Message message) {
        // 回查本地事务状态
        System.out.println("回查事务状态：" + message.getPayload());
        return RocketMQLocalTransactionState.COMMIT;
    }
}

4.3 Controller 测试入口

package com.example.rocketmq.controller;

import com.example.rocketmq.producer.TransactionalMessageProducer;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/transaction")
public class TransactionalMessageController {

    @Autowired
    private TransactionalMessageProducer producer;

    @PostMapping("/send")
    public String sendTransactionalMessage(@RequestParam String message) {
        producer.send("transactional-topic", message);
        return "事务消息发送成功";
    }
}

---

5. 消息发送重试与流控机制

应用场景

• 网络抖动、Broker瞬时不可用时，重试保证消息送达。
• 高并发场景限流，保护 Broker，防止系统雪崩。

配置方式

在 application.yml 配置发送重试次数：

spring:
  rocketmq:
    producer:
      retry-times-when-send-failed: 5 # 默认3次，这里改为5次

---

6. 消费者分类（Consumer Group）

应用场景

• 统计系统和风控系统都需要消费订单完成消息，但彼此独立。

完整代码

6.1 消费者1（统计系统）

package com.example.rocketmq.consumer;

import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.springframework.stereotype.Service;

/**
 * 统计系统消费者
 */
@Service
@RocketMQMessageListener(topic = "order-finished-topic", consumerGroup = "analytics-consumer-group")
public class AnalyticsConsumer implements RocketMQListener<String> {

    @Override
    public void onMessage(String message) {
        System.out.println("【统计系统】收到订单完成消息：" + message);
    }
}

6.2 消费者2（风控系统）

package com.example.rocketmq.consumer;

import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.springframework.stereotype.Service;

/**
 * 风控系统消费者
 */
@Service
@RocketMQMessageListener(topic = "order-finished-topic", consumerGroup = "risk-control-consumer-group")
public class RiskControlConsumer implements RocketMQListener<String> {

    @Override
    public void onMessage(String message) {
        System.out.println("【风控系统】收到订单完成消息：" + message);
    }
}

---

7. 消息过滤（Message Filter）

应用场景

• 不同类型订单按需消费，比如只处理高价值订单。

7.1 Tag 过滤

生产者发送消息时打 Tag：

rocketMQTemplate.syncSend("filter-topic:vip", "VIP用户下单");
rocketMQTemplate.syncSend("filter-topic:normal", "普通用户下单");

消费者按 Tag 订阅：

package com.example.rocketmq.consumer;

import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.springframework.stereotype.Service;

/**
 * Tag过滤消费者
 */
@Service
@RocketMQMessageListener(topic = "filter-topic", consumerGroup = "vip-consumer-group", selectorExpression = "vip")
public class TagFilterConsumer implements RocketMQListener<String> {

    @Override
    public void onMessage(String message) {
        System.out.println("【VIP订单】收到消息：" + message);
    }
}

🚨注意：Tag 过滤只能是单标签或者 || 组合。

---

8. 消费者负载均衡（Load Balance）

应用场景

• 大促期间流量激增，水平扩展消费端。

RocketMQ 默认机制

• 同一 Consumer Group 内，多个消费者实例自动分摊队列（Queue）。

示意：

Queue	Consumer1	Consumer2
Q0	✔️
Q1	✔️
Q2		✔️
Q3		✔️

👉实际代码和上面一样，只需要部署多个实例**，RocketMQ 自动分配。

---

9. 消费进度管理（Offset Management）

应用场景

• 确保消息消费成功，失败时可以断点续传，不丢消息。

RocketMQ 默认

• 自动提交 Offset，确保 At Least Once。

若想手动控制（进阶用法，适合批量消费）需改用底层 API MessageListenerConcurrently。

---

10. 消息重试（Message Retry）

应用场景

• 消费失败，RocketMQ 自动进行重试，最大16次。

完整代码

消费者模拟失败

package com.example.rocketmq.consumer;

import org.apache.rocketmq.spring.annotation.RocketMQMessageListener;
import org.apache.rocketmq.spring.core.RocketMQListener;
import org.springframework.stereotype.Service;

/**
 * 消息重试消费者
 */
@Service
@RocketMQMessageListener(topic = "retry-topic", consumerGroup = "retry-consumer-group")
public class RetryConsumer implements RocketMQListener<String> {

    @Override
    public void onMessage(String message) {
        System.out.println("【重试机制】收到消息：" + message);
        if (message.contains("fail")) {
            throw new RuntimeException("消费失败，触发重试");
        }
    }
}

RocketMQ 会根据消费失败次数进行重试，超过最大次数会进入 死信队列 DLQ。

---

11. 消息存储和清理机制（Storage & Cleanup）

应用场景

• 大量堆积消息时，合理清理过期消息，防止磁盘爆满。

Broker 配置（broker.conf）

fileReservedTime=72 # 消息保存时间（小时）
cleanFileForciblyEnable=true # 启用强制清理

清理规则：

• 消息保存超过 fileReservedTime 时间，会被清除。
• 磁盘使用率超过阈值（75%），触发强制清理。

---

🚀完整测试方法

1. 启动 RocketMQ 集群（见下）
2. 启动本项目
3. 通过 Postman、curl 调用各 Controller 接口

---

🐳本地 RocketMQ 快速启动 (Docker版)

新建 docker-compose.yml：

version: '3.7'
services:
  namesrv:
    image: apache/rocketmq:4.9.3
    container_name: rmqnamesrv
    ports:
      - "9876:9876"
    environment:
      JAVA_OPT_EXT: "-Xms512m -Xmx512m"
    command: sh mqnamesrv

  broker:
    image: apache/rocketmq:4.9.3
    container_name: rmqbroker
    ports:
      - "10911:10911"
      - "10909:10909"
    environment:
      JAVA_OPT_EXT: "-Xms512m -Xmx512m"
      NAMESRV_ADDR: namesrv:9876
      BROKER_ID: 0
      BROKER_NAME: broker-a
      BROKER_CLUSTER_NAME: DefaultCluster
    volumes:
      - ./broker.conf:/opt/rocketmq-4.9.3/conf/broker.conf
    command: sh mqbroker -c /opt/rocketmq-4.9.3/conf/broker.conf
    depends_on:
      - namesrv

新建 broker.conf：

brokerClusterName=DefaultCluster
brokerName=broker-a
brokerId=0
deleteWhen=04
fileReservedTime=48
brokerRole=ASYNC_MASTER
flushDiskType=ASYNC_FLUSH
listenPort=10911

执行启动：

docker-compose up -d

---

🎯总结

功能特性	项目应用场景
普通消息	用户注册、订单通知、积分发放
定时/延时消息	超时关单、定时推送
顺序消息	订单流转、物流更新
事务消息	下单扣库存一致性控制
消息发送重试	保证网络异常时消息可靠送达
消费者分类	多业务系统独立消费
消息过滤	精准推送特定类型消息
消费者负载均衡	消费者水平扩展
消费进度管理	消费状态持久化，防止重复丢失
消息重试	消费异常自动重试，保护业务处理
存储清理机制	硬盘保护，防止大数据量堆积导致系统崩溃