RocketMQ消息过滤实现方法详解
时间:2025-07-05 13:13:43 144浏览 收藏
一分耕耘,一分收获!既然都打开这篇《Java实现RocketMQ消息过滤方法》,就坚持看下去,学下去吧!本文主要会给大家讲到等等知识点,如果大家对本文有好的建议或者看到有不足之处,非常欢迎大家积极提出!在后续文章我会继续更新文章相关的内容,希望对大家都有所帮助!
Java操作RocketMQ实现消息过滤的核心方式是Tag和SQL表达式。1. Tag过滤适用于简单分类,通过设置Tag并使用||订阅多个Tag提高效率;2. SQL表达式过滤支持AND、OR、NOT及比较运算符,需在Broker中开启enablePropertyFilter并设置用户属性;3. 选择时根据需求复杂度决定,Tag适合简单场景,SQL适合复杂条件;4. 性能优化包括简化表达式、控制Tag数量、启用缓存、优化属性及监控性能;5. 排查SQL失效需检查Broker配置、语法、属性设置及日志;6. 还可自定义MessageFilter实现灵活过滤。合理选择与优化过滤方式有助于提升消费效率并降低负载。
Java操作RocketMQ,核心在于利用Tag和SQL表达式实现消息过滤,提高消费效率。

解决方案

RocketMQ提供了两种主要的消息过滤方式:基于Tag的过滤和基于SQL表达式的过滤。选择哪种取决于你的具体需求和消息属性的复杂程度。
基于Tag的过滤
Tag过滤是最简单的一种方式。发送消息时,为每条消息设置一个Tag。消费者在订阅时,可以指定要消费的Tag。
- 发送消息:
DefaultMQProducer producer = new DefaultMQProducer("group_name"); producer.setNamesrvAddr("your_namesrv_address"); producer.start(); Message msg = new Message("TopicTest", "TagA", "OrderID001", "Hello world".getBytes(RemotingHelper.DEFAULT_CHARSET)); SendResult sendResult = producer.send(msg); System.out.printf("%s%n", sendResult); producer.shutdown();
- 消费消息:
DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("please_rename_unique_group_name_4"); consumer.setNamesrvAddr("your_namesrv_address"); consumer.subscribe("TopicTest", "TagA || TagB || TagC"); // 订阅TagA、TagB或TagC的消息 consumer.registerMessageListener(new MessageListenerConcurrently() { @Override public ConsumeConcurrentlyStatus consumeMessage(List
msgs, ConsumeConcurrentlyContext context) { System.out.printf("%s Receive New Messages: %s %n", Thread.currentThread().getName(), msgs); return ConsumeConcurrentlyStatus.CONSUME_SUCCESS; } }); consumer.start(); 注意点:
- Tag过滤效率高,适用于简单的消息分类。
- Tag的数量不宜过多,避免影响性能。
- 消费者可以使用
||
运算符订阅多个Tag。
基于SQL表达式的过滤
SQL表达式过滤允许你使用更复杂的条件来过滤消息。你需要先开启Broker的SQL过滤功能,然后在发送消息时设置用户属性,消费者使用SQL表达式进行过滤。
开启Broker SQL过滤 (重要)
在
broker.conf
文件中添加enablePropertyFilter=true
,重启Broker。 如果不开启,SQL过滤会失效。发送消息:
DefaultMQProducer producer = new DefaultMQProducer("group_name"); producer.setNamesrvAddr("your_namesrv_address"); producer.start(); Message msg = new Message("TopicTest", "TagA", "OrderID001", "Hello world".getBytes(RemotingHelper.DEFAULT_CHARSET)); msg.putUserProperty("age", String.valueOf(18)); // 设置用户属性 SendResult sendResult = producer.send(msg); System.out.printf("%s%n", sendResult); producer.shutdown();
- 消费消息:
DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("please_rename_unique_group_name_4"); consumer.setNamesrvAddr("your_namesrv_address"); // 使用MessageSelector指定SQL表达式 consumer.subscribe("TopicTest", MessageSelector.bySql("age > 10 AND age < 20")); // 订阅age大于10且小于20的消息 consumer.registerMessageListener(new MessageListenerConcurrently() { @Override public ConsumeConcurrentlyStatus consumeMessage(List
msgs, ConsumeConcurrentlyContext context) { System.out.printf("%s Receive New Messages: %s %n", Thread.currentThread().getName(), msgs); return ConsumeConcurrentlyStatus.CONSUME_SUCCESS; } }); consumer.start(); 注意点:
- SQL表达式过滤功能需要Broker支持。
- SQL表达式的语法有限制,只能使用
AND
,OR
,NOT
,=
,>
,<
,>=
,<=
,IN
,BETWEEN
等运算符。 - 支持的数据类型包括
NUMERIC
,BOOLEAN
,STRING
。 - SQL过滤的性能比Tag过滤略低,但灵活性更高。
如何选择合适的过滤方式?
如果只需要简单的消息分类,Tag过滤更简单高效。如果需要基于消息属性进行更复杂的过滤,SQL表达式过滤更适合。 实际应用中,可以结合使用这两种方式,例如先使用Tag过滤缩小范围,再使用SQL表达式过滤精确匹配。
RocketMQ消息过滤的性能优化策略有哪些?
- 减少过滤表达式的复杂度: 复杂的SQL表达式会增加Broker的过滤负担,尽量简化表达式,避免使用过多的
AND
和OR
运算符。 - 合理设置Tag数量: Tag数量过多会导致Broker的索引变大,影响性能。根据实际情况,合理划分Tag。
- 开启Broker的SQL过滤缓存: RocketMQ Broker可以缓存SQL过滤结果,减少重复计算。可以通过配置参数开启缓存。
- 优化消息属性: 消息属性的数据类型和大小会影响过滤性能。尽量使用简单的数据类型,避免使用过大的字符串。
- 监控Broker性能: 通过监控Broker的CPU、内存和磁盘IO等指标,及时发现性能瓶颈。
如果SQL表达式过滤不起作用,应该如何排查?
- 确认Broker是否开启SQL过滤功能: 检查
broker.conf
文件中是否配置了enablePropertyFilter=true
,并重启了Broker。 - 检查SQL表达式语法是否正确: RocketMQ的SQL表达式语法有一定限制,确保表达式符合规范。可以参考RocketMQ官方文档。
- 检查消息属性是否设置正确: 确认消息中是否设置了SQL表达式中使用的属性,并且属性名称和数据类型是否正确。
- 检查消费者订阅的Topic和Tag是否正确: 确保消费者订阅的Topic和Tag与生产者发送的消息一致。
- 查看Broker日志: 查看Broker日志,查找是否有SQL过滤相关的错误信息。
- 使用简单的SQL表达式进行测试: 先使用简单的SQL表达式进行测试,例如
age > 10
,如果可以正常工作,再逐步增加表达式的复杂度。
除了Tag和SQL表达式,还有没有其他的消息过滤方式?
虽然Tag和SQL表达式是最常用的过滤方式,但RocketMQ也支持自定义消息过滤。你可以通过实现MessageFilter
接口,编写自己的过滤逻辑。
- 自定义MessageFilter:
public class MyMessageFilter implements MessageFilter { @Override public boolean match(MessageExt msg, FilterContext context) { String propertyValue = msg.getUserProperty("your_property"); // 自定义过滤逻辑 return propertyValue != null && propertyValue.equals("your_value"); } }
- 消费者使用自定义MessageFilter:
DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("please_rename_unique_group_name_4"); consumer.setNamesrvAddr("your_namesrv_address"); // 使用自定义MessageFilter consumer.subscribe("TopicTest", "*", new MyMessageFilter()); // ... 剩余代码
自定义消息过滤提供了更高的灵活性,但也需要更多的开发工作。通常情况下,Tag和SQL表达式过滤已经可以满足大部分需求。
在实际应用中,选择合适的消息过滤方式,并进行适当的性能优化,可以有效地提高RocketMQ的消费效率,降低系统负载。
今天带大家了解了的相关知识,希望对你有所帮助;关于文章的技术知识我们会一点点深入介绍,欢迎大家关注golang学习网公众号,一起学习编程~
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
105 收藏
-
423 收藏
-
177 收藏
-
181 收藏
-
141 收藏
-
140 收藏
-
467 收藏
-
296 收藏
-
381 收藏
-
344 收藏
-
370 收藏
-
266 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 511次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 498次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 484次学习