更新时间:2025-07-29 GMT+08:00

重置RocketMQ消费进度

重置RocketMQ消费进度即修改消费者的消费位置,重置消费进度后,消费者会从修改后的消息位置开始继续消费。

背景信息

RocketMQ通过消费位点管理消息的消费进度。每条消息被某个消费者消费完成后不会立即在队列中删除,RocketMQ会基于每个消费组维护一份消费记录,该记录指定了消费组下的消费者消费指定Topic时,消费过的最新一条消息的位点,即消费位点。当消费者客户端离线又再次重新上线时,消费者会严格按照服务端保存的消费进度继续处理消息。

如果希望重新消费或跳过消费部分消息,您可以通过重置消费位点调整您的消费进度。

操作视频

本视频演示重置RocketMQ消费进度的操作。

约束限制

  • 重置消费位点的范围是重置指定消费组对于目标Topic的消费位点,因此不会影响其他订阅了该Topic的消费组的消费进度。
  • 广播消费模式下不支持重置消费位点。
  • 重置消费位点功能只能重置对消费者可见的消息,不能重置定时中、重试等待中的消息。
  • 重试消费位点只能在消费者在线时进行操作。

前提条件

重置RocketMQ消费进度

  1. 登录管理控制台。
  2. 在管理控制台左上角单击,选择区域。

    不同区域的云服务产品之间内网互不相通。请就近选择靠近您业务的区域,可减少网络时延,提高访问速度。

  3. 在管理控制台左上角单击,选择“应用中间件 > 分布式消息服务RocketMQ版”,进入分布式消息服务RocketMQ页面。
  4. 单击RocketMQ实例的名称,进入实例详情页面。
  5. 在左侧导航栏,单击“实例管理 > 消费组管理”,进入消费组列表页面。
  6. 在待重置消费进度的消费组所在行,单击“重置消费进度”,弹出“重置消费进度”对话框。
  7. 参考表1,设置重置消费进度参数。

    表1 重置消费进度参数说明

    参数

    说明

    Topic名称

    选择待重置消费进度的Topic。

    时间

    选择重置消费进度的时间点,重置完成后,将从此时间点开始消费。

    • 自定义:自定义时间点,即从自定义的时间点重新开始消费消息。
    • 最早:最早偏移量,即从头开始消费所有消息。
    • 最晚:最晚偏移量,即当前时间之前的所有消息全部不消费了,只从当前时间重新开始消费消息。

  8. 单击“确定”,弹出“重置消费进度确认”对话框。

    重置消费进度可能会导致重复消费,请谨慎操作。

  9. 单击“是”,完成消费进度的重置。

相关文档

重置消费进度也可以通过调用API完成,具体请参见重置消费进度