RocketMQ延时消息的使用和延时级别的配置

RocketMQ 支持定时消息，但是不支持任意时间精度，仅支持特定的 level，例如定时 5s， 10s， 1m 等。其中，level=0 级表示不延时，level=1 表示 1 级延时，level=2 表示 2 级延时，以此类推。

如何配置

在服务器端（rocketmq-broker端）的属性配置文件中加入以下行：

messageDelayLevel=1s 5s 10s 30s 1m 2m 3m 4m 5m 6m 7m 8m 9m 10m 20m 30m 1h 2h

描述了各级别与延时时间的对应映射关系。

1. 这个配置项配置了从1级开始，各级延时的时间，可以修改这个指定级别的延时时间；
2. 时间单位支持：s、m、h、d，分别表示秒、分、时、天；
3. 默认值就是上面声明的，可手工调整；
4. 默认值已够用，不建议修改这个值。

如何发送延时消息

发送延时消息只需要在客户端（rocketmq-client端）待发送的消息（ com.alibaba.rocketmq.common.message.Message ）中设置延时级别即可。

“设置消息延时 10s 消费”的 Producer 端代码如下：

1 2 3 4 5

Message msg = new Message(topic, tags, keys, body); msg.setDelayTimeLevel(3); ... SendResult sendResult = getMQProducer().send(msg); ...

其中 Message 是 com.alibaba.rocketmq.common.message.Message 。

参考资料

• 《RocketMQ 开发指南V3.2.4》
• com.alibaba.rocketmq.store.schedule.ScheduleMessageService.parseDelayLevel()
• com.alibaba.rocketmq.store.config.MessageStoreConfig.messageDelayLevel