《RocketMQ 官网》阅读笔记 RocketMQ 订阅 (Subscription)
2026/7/27 15:24:25 网站建设 项目流程

《RocketMQ 官网》阅读笔记 RocketMQ 订阅 (Subscription)

订阅 (Subscription)

定义

订阅是 Apache RocketMQ 中消费者获取和处理消息的规则与状态设置。
订阅由消费者组动态注册到服务端(Broker)。消息会根据订阅中定义的过滤规则进行匹配和消费。
通过配置订阅,您可以控制以下消息行为:

  • 消息过滤规则:这些规则用于定义消费者消费主题(Topic)中的哪些消息。通过配置消息过滤规则,消费者可以有效地获取所需的消息,并根据不同的业务场景指定消息接收范围。
  • 消费状态:默认情况下,Apache RocketMQ 服务端提供持久化订阅。也就是说,在消费者组订阅了某个服务端后,即使组内的消费者重新连接,它们也可以从上次停止消费的位置继续消费消息。

订阅的判定规则

Apache RocketMQ 的订阅基于消费者组和主题进行设计。因此,订阅是指特定的消费者组对某个主题的订阅。以下描述了订阅的判定规则:

模型关系

下图展示了订阅在 Apache RocketMQ 领域模型中的位置。

内部属性

过滤类型

消息过滤规则的类型。为订阅设置消息过滤规则后,系统会根据该规则匹配主题中的消息。只有满足条件的消息才会投递给 消费者。此功能可帮助您根据需求对发送给消费者的消息进行分类。

  • Tag 过滤:基于标签字符串进行全文本过滤和匹配。
  • SQL92 过滤:基于 SQL 语法对消息属性进行过滤和匹配。

过滤表达式

  • 自定义过滤规则的表达式。
  • https://rocketmq.apache.ac.cn/docs/featureBehavior/07messagefilter/

行为约束

订阅一致性

Apache RocketMQ 基于消费者组管理订阅。因此,同一个消费者组内的消费者必须保持相同的消费逻辑。否则,会发生消费冲突,进而导致部分消息被错误地消费。
正确示例

//Consumer c1Consumerc1=ConsumerBuilder.build(groupA);c1.subscribe(topicA,"TagA");//Consumer c2Consumerc2=ConsumerBuilder.build(groupA);c2.subscribe(topicA,"TagA");

错误示例

//Consumer c1Consumerc1=ConsumerBuilder.build(groupA);c1.subscribe(topicA,"TagA");//Consumer c2Consumerc2=ConsumerBuilder.build(groupA);c2.subscribe(topicA,"TagB");

使用说明

请勿频繁修改订阅。

在 Apache RocketMQ 中,订阅与元数据以及过滤规则、消费进度等配置相关联。系统必须确保消费者组中所有消费者的消费行为、消费逻辑和负载策略保持一致。这些因素导致需要管理的关系网络非常复杂。因此,我们建议不要在生产环境中频繁修改订阅以变更业务逻辑。否则,客户端需要不断调整负载分布,这会导致消息接收问题。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询