查询定时与延时消息

最近更新时间: 2026-06-30 15:06:00

操作场景

定时/延时消息是 RocketMQ 中比较重要的消息类型。

  • 定时消息:消息在发送至服务端后,实际业务并不希望消费端马上收到这条消息,而是推迟到某个时间点被消费,这类消息统称为定时消息。
  • 延时消息:消息在发送至服务端后,实际业务并不希望消费端马上收到这条消息,而是推迟一段时间后再被消费,这类消息统称为延时消息。
    实际上,延时消息可以看成是定时消息的一种特殊用法,其实现的最终效果和定时消息是一致的。

查询限制

由于 RocketMQ 给消息设置有消息保留时间,即消费完成的消息会在服务端保留一段时间(体验版和基础版的时间为 3 天,专业版和铂金版支持 Topic 维度的时间调整,支持7天及更长时间),在消息的保留时间内的延时和定时消息均可被查询到。
例如:假设某集群于 1月1日1时发送了一条延时10天的延时消息,集群的保留时间为三天,则1月11日1时,消息发送给消费者,假定消费者消费成功,则在1月14日1时前,均可以在当前页面查询到本条消息。

说明:

当前仅 5.x 集群支持查询定时和延时消息

操作步骤

  1. 登录 TDMQ RocketMQ 控制台,在左侧导航栏单击延时消息查询
  2. 在消息查询页面,选择好地域后根据页面提示输入查询条件。
    • 集群:选择需要查询的延时消息所在的集群。
    • 消息 ID:填写 Message ID 精确定位到任意一条消息。
  3. 单击查询,下方列表会展示所有查询到的结果并分页展示。
  4. 完成查询后,可以查看消息的创建和生产时间,和其他的消息查询结果类似,可以对消息进行查看轨迹和导出等操作。
  5. 单击操作列的查看消息轨迹,或者在详情页单击 Tab 栏的消息轨迹,即可查看该消息的消息轨迹(详细说明请参见 消息轨迹与说明)。在 “消息消费” 部分可以查看到对应消息的定时到期发送消息的时间和消费状态。