阅读145 返回首页    go 阿里云


消息重试__最佳实践_消息队列 MQ-阿里云

本文档主要介绍 MQ 消费者的消费逻辑失败时,通过设置返回状态可达到消息重试的结果。

MQ 消息重试只针对集群消费方式生效;广播方式不提供失败重试特性,即消费失败后,失败消息不再重试,继续消费新的消息。

重试次数

MQ 默认允许每条消息最多重试 16 次,每次重试的间隔时间如下:

第几次重试 每次重试间隔时间 第几次重试 每次重试间隔时间
1 10 秒 9 7 分钟
2 30 秒 10 8 分钟
3 1 分钟 11 9 分钟
4 2 分钟 12 10 分钟
5 3 分钟 13 20 分钟
6 4 分钟 14 30 分钟
7 5 分钟 15 1 小时
8 6 分钟 16 2 小时

如果消息重试16次后仍然失败,消息将不再投递。如果严格按照上述重试时间间隔计算,某条消息在一直消费失败的前提下,将会在接下来的4小时46分钟之内进行16次重试,超过这个时间范围消息将不再重试投递。

配置方式

消费失败后,重试配置方式

集群消费方式下,消息消费失败后期望消息重试,需要在消息监听器接口的实现中明确进行配置(三种方式任选一种):

  • 返回 Action.ReconsumeLater (推荐)
  • 返回 Null
  • 抛出异常

代码示例如下:

  1. public class MessageListenerImpl implements MessageListener {
  2. @Override
  3. public Action consume(Message message, ConsumeContext context) {
  4. //方法3:消息处理逻辑抛出异常,消息将重试
  5. doConsumeMessage(message);
  6. //方式1:返回 Action.ReconsumeLater, 消息将重试
  7. return Action.ReconsumeLater;
  8. //方式2:返回 null, 消息将重试
  9. return null;
  10. //方式3:直接抛出异常 , 消息将重试
  11. throw new RuntimeException("Consumer Message exceotion");
  12. }
  13. }

消费失败后,不重试配置方式

集群消费方式下,消息失败后期望消息不重试,需要捕获消费逻辑中可能抛出的异常,最终返回 Action.CommitMessage,此后这条消息将不会再重试。代码示例如下:

  1. public class MessageListenerImpl implements MessageListener {
  2. @Override
  3. public Action consume(Message message, ConsumeContext context) {
  4. try {
  5. doConsumeMessage(message);
  6. } catch (Throwable e) {
  7. //捕获消费逻辑中的所有异常 , 并返回 Action.CommitMessage;
  8. return Action.CommitMessage;
  9. }
  10. //消息处理正常 , 直接返回 Action.CommitMessage;
  11. return Action.CommitMessage;
  12. }
  13. }

自定义消息最大重试次数

自定义 MQ 客户端日志配置,请升级 TCP Java SDK 版本到1.2.2及以上。

MQ 允许 Consumer 启动的时候设置最大重试次数,重试时间间隔将按照如下策略:

  • 最大重试次数小于等于16次,则重试时间间隔同上表描述。
  • 最大重试次数大于16次,超过16次的重试时间间隔均为每次2小时。

配置方式如下:

  1. Properties properties = new Properties();
  2. //配置对应 Consumer ID 的最大消息重试次数为20 次
  3. properties.put(PropertyKeyConst.MaxReconsumeTimes,20);
  4. Consumer consumer =ONSFactory.createConsumer(properties);

注意:

  • 消息最大重试次数的设置对相同 Consumer ID 下的所有 Consumer 实例有效。
  • 如果只对配置了相同 Consumer ID 的两个 Consumer 实例中的其中一个设置了 MaxReconsumeTimes,那么该配置对两个 Consumer 实例均生效。
  • 配置采用覆盖的方式生效,即最后启动的 Consumer 实例会覆盖之前的启动实例的配置。

获取消息重试次数

消费者收到消息后,可按照如下方式获取消息的重试次数:

  1. public class MessageListenerImpl implements MessageListener {
  2. @Override
  3. public Action consume(Message message, ConsumeContext context) {
  4. //获取消息的重试次数
  5. System.out.println(message.getReconsumeTimes());
  6. return Action.CommitMessage;
  7. }
  8. }

最后更新:2016-11-23 16:04:17

  上一篇:go 删除授权__资源授权接口_Open API_消息队列 MQ-阿里云
  下一篇:go 订阅关系一致__最佳实践_消息队列 MQ-阿里云