Spring中基于redis stream 的消息队列实现方法

<think>嗯，用户想了解在Spring Boot中使用Redis Stream实现消息队列的示例教程。首先，我需要回忆一下Redis Stream的相关知识，以及如何在Spring Boot中集成它。记得Redis Stream是Redis 5.0引入的数据结构，支持消息持久化和消费者组，适合作为消息队列使用。 首先，用户可能需要先配置环境，比如添加依赖。根据引用[3]，需要引入Spring Boot的Redis starter依赖。所以应该先检查pom.xml中的依赖是否正确，比如spring-boot-starter-data-redis。 然后配置Redis连接信息，比如在application.yml中设置host和port。接下来，创建RedisTemplate或者StringRedisTemplate的Bean，不过可能Spring Boot已经自动配置了，但用户可能需要自定义配置，比如设置序列化方式。 接下来是具体的代码实现。生产者部分，需要使用XADD命令来添加消息到Stream中。在Spring Data Redis中，可能通过redisTemplate.opsForStream().add()方法来实现。需要指定Stream的key、消息体的字段和值。 消费者部分比较复杂，因为涉及到消费者组的创建和消息的读取。根据引用[4]，可以手动创建消费者组，或者在代码中调用createGroup方法。可能需要使用StreamMessageListenerContainer来监听消息，并处理接收到的消息。 需要注意的地方包括消费者组的初始化，确保在应用启动时创建消费者组，避免重复创建导致的错误。另外，消息确认机制也很重要，处理完消息后需要调用acknowledge方法进行确认，防止消息被重复消费。 示例代码可能需要分为配置类、生产者服务类、消费者配置类以及测试部分。在配置类中设置Redis连接和模板；生产者服务提供发送消息的方法；消费者配置类里设置监听容器，并定义消息处理的逻辑。 用户可能还会关心如何测试整个流程，比如发送消息后如何验证消费者是否接收到。可能需要编写一个Controller来触发消息发送，并通过日志查看消费者的处理情况。 另外，根据引用[3]和引用[4]，使用Redis Stream相比List和发布/订阅模型的优势在于持久化和消费者组支持，适合需要可靠消息传递的场景。不过也要提醒用户，Redis作为消息队列在消息量大的情况下可能不如专业的消息中间件，需要根据实际需求选择。 最后，需要确保示例中的代码符合最佳实践，比如异常处理、资源清理等。同时，检查LaTeX格式是否正确，行内公式用$...$，独立公式用$$...$$，并生成相关问题供用户进一步学习。</think>### Spring Boot + Redis Stream 消息队列实现步骤 #### 一、环境准备 1. 添加依赖（需与引用[3]保持一致）： ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-redis</artifactId> </dependency> ``` 2. 配置`application.yml`： ```yaml spring: redis: host: 127.0.0.1 port: 6379 password: stream: key: redis-stream-01 # 自定义Stream名称 ``` #### 二、核心代码实现 1. **生产者服务**： ```java @Service public class StreamProducer { @Autowired private StringRedisTemplate redisTemplate; public void sendMessage(Map<String, String> message) { // 使用Spring Data Redis的Stream操作API RecordId recordId = redisTemplate.opsForStream() .add(StreamRecords.newRecord() .ofStrings(message) .withStreamKey("redis-stream-01")); System.out.println("消息ID:" + recordId); } } ``` 2. **消费者组初始化**（引用[4]实现方式）： ```java @Configuration public class RedisConfig { @Autowired private RedisConnectionFactory redisConnectionFactory; @Bean public StreamMessageListenerContainer<String, ObjectRecord<String, String>> listenerContainer() { // 创建消费者组（需确保只初始化一次） RedisTemplate<String, String> redisTemplate = new RedisTemplate<>(); redisTemplate.setConnectionFactory(redisConnectionFactory); redisTemplate.afterPropertiesSet(); redisTemplate.opsForStream().createGroup("redis-stream-01", "group-a"); // 配置监听容器 StreamMessageListenerContainer.StreamMessageListenerContainerOptions<String, ObjectRecord<String, String>> options = StreamMessageListenerContainer.StreamMessageListenerContainerOptions .builder() .pollTimeout(Duration.ofSeconds(1)) .build(); return StreamMessageListenerContainer.create(redisConnectionFactory, options); } } ``` 3. **消息监听处理器**： ```java @Component public class StreamConsumer implements ApplicationRunner { @Autowired private StreamMessageListenerContainer<String, ObjectRecord<String, String>> listenerContainer; @Override public void run(ApplicationArguments args) { listenerContainer.receive(Consumer.from("group-a", "consumer-1"), StreamOffset.create("redis-stream-01", ReadOffset.lastConsumed()), message -> { // 处理消息逻辑 System.out.println("收到消息：" + message.getValue()); // 消息确认（ACK） listenerContainer.getContainerOptions().getStreamOperations() .acknowledge("redis-stream-01", "group-a", message.getId()); }); listenerContainer.start(); } } ``` #### 三、测试验证 1. 发送测试消息： ```java @RestController public class TestController { @Autowired private StreamProducer producer; @GetMapping("/send") public String sendMsg() { Map<String, String> msg = new HashMap<>(); msg.put("orderId", "1001"); msg.put("amount", "299.00"); producer.sendMessage(msg); return "消息已发送"; } } ``` 2. 通过Redis-cli查看消息： ```shell XREAD COUNT 10 STREAMS redis-stream-01 0 ``` #### 四、关键特性说明 1. **消息持久化**：Redis Stream使用$radix$树结构存储消息，所有消息永久保存[^3] 2. **消费组特性**： - 支持多个独立消费者组 - 通过`XACK`实现消息确认 - 消息消费进度通过$last_delivered_id$维护[^4] 3. **性能指标**：单节点吞吐量可达$10^4$级别QPS