tencent cloud

消息队列 RocketMQ 版

动态与公告
新功能发布记录
公告
产品简介
产品概述
什么是消息队列 RocketMQ 版
产品优势
应用场景
产品系列
开源对比
高可用
使用限制
开服地域
基本概念
产品计费
计费概述
价格说明
计费示例
切换集群计费模式(5.x)
续费说明
查看消费明细
退费说明
欠费说明
快速入门
快速入门概述
准备工作
步骤1:创建 RocketMQ 资源
步骤2:使用 SDK 收发消息(推荐)
步骤2:运行 RocketMQ 客户端(可选)
步骤3:查询消息
步骤4:销毁资源
用户指南
使用流程指引
配置账号权限
新建集群
命名空间管理
配置 Topic
配置 Group
连接集群
管理消息
管理集群
查看监控和配置告警
跨集群复制消息
实践教程
RocketMQ 常见概念命名规范
RocketMQ 客户端实践
RocketMQ 性能压测和容量评估
使用社区版 HTTP SDK 接入
客户端风险说明和更新指南
关于 RocketMQ 4.x 集群角色(Role)相关云 API 迁移指引
迁移指南
有感迁移
无感迁移
开发指南
消息类型
消息过滤
消息重试
POP 消费模式(5.x)
集群消费与广播消费
订阅关系一致性
限流
API 参考(5.x)
History
API Category
Making API Requests
Topic APIs
Consumer Group APIs
Message APIs
Role Authentication APIs
Hitless Migration APIs
Cloud Migration APIs
Cluster APIs
Data Types
Error Codes
API 参考(4.x)
SDK 参考
SDK 概述
5.x SDK
4.x SDK
安全与合规
权限管理
云 API 审计
删除保护
常见问题
4.x 实例常见问题
服务协议
服务等级协议
联系我们

重置消费进度

PDF
聚焦模式
字号
最后更新时间: 2026-01-23 16:50:32
消费进度(offset)表示消费者消费消息的位置,在某些业务场景下,例如数据处理异常、业务逻辑变更或系统运维需求,可能会需要重置消费位点,以重新消费或跳过特定消息。

约束与限制

TDMQ RocketMQ 版支持给离线的 Group 重置 offset(消费位点),但目前仅支持 Push 消费模式下的消费者组,否则会出现重置失败的情况。

操作步骤

2. 在左侧导航栏选择资源管理 > 集群管理,选择好地域后,单击目标集群的“ID”,进入集群基本信息页面。
3. 在集群基本信息页面,选择 Group 页签:
5.x 集群:单击目标 Group 操作列的重置位点。

4.x 集群:单击目标 Group 操作列的重置位点或者重置重试队列位点。

关于重置重试队列位点的说明:
特性
4.x 集群
5.x 集群
重试队列粒度
以 Group 为单位
一个 Group 只有一个重试队列,它订阅的所有 Topic 的失败消息都发到这里。
以 Group&Topic 为粒度
一个 Group 针对它订阅的每个 Topic,都会有一个独立的专属重试队列。
重置普通队列的影响
重置某个 Topic 的消费位点时,不会自动重置重试队列。
重置某个 Topic 的消费位点时,会自动重置与之对应的那个专属重试队列的位点。
为何这样设计?
为了避免“交叉影响”。
如果一个 Group 订阅了 Topic A 和 Topic B,当重置 Topic A 的位点时,如果也重置了共用的重试队列,那么 Topic B 的失败消息也会被影响。
因为天然隔离。
每个 Topic 都有自己独立的“重试队列”,重置 Topic A 时,只会动 Topic A 自己的重试队列,不会影响 Topic B 的重试队列,所以可以安全地自动完成。
额外功能
提供了一个独立的 “重置重试队列位点” 功能。如果需要清除所有失败消息,可以单独执行这个操作。
无需额外功能,因为重置 Topic 时已自动处理。
4. 在弹窗中,可以选择从最新位点开始或者从指定时间点开始设定 Topic 的消费位移 offset(即指定该订阅下的消费者从哪里开始消费消息)。
如果选择重置位点“从最新位点开始”,则 Group 在指定 Topic 中的堆积消息将被全部清除,请谨慎操作。



5. 单击提交,完成设置。




帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈