Azure Service Bus主题消费失败无法重试直接进入死信队列问题排查

问题根因与解决方案 #

你遇到的第一次消费失败直接进入死信队列的问题，常见原因和对应解决方法如下：

• 优先检查Azure Service Bus对应订阅的最大投递次数(Max Delivery Count) 配置
  ASB服务端本身会对每个队列/订阅配置最大投递次数，该配置优先级高于你代码里的投递次数判断：如果服务端配置的最大投递次数为1，那么第一次你调用AbandonAsync之后，服务端会直接将消息移入死信队列，不会触发二次投递。
  解决方法：进入Azure门户找到对应Service Bus主题的订阅配置，将「最大递送计数」调整为≥5的数值（你需要最多重试5次的话，设置为5即可）。
• 检查AbandonAsync调用是否成功
  若你的消息处理逻辑耗时超过了消息锁的有效时长（默认30秒，和你配置的MaxAutoRenewDuration一致），调用AbandonAsync时会因为锁过期抛出异常，此时你的catch块逻辑不会生效，ASB服务端会自动增加投递次数，如果服务端最大投递次数为1就会直接死信。
  解决方法：
  1. 为catch块添加日志，输出message.SystemProperties.DeliveryCount的值以及AbandonAsync的调用异常，确认是否存在锁过期问题
  2. 若处理逻辑确实耗时较长，适当调大MaxAutoRenewDuration和订阅的默认锁持续时间
• 排查是否有其他消费者实例同时消费该订阅
  如果有多个进程/实例同时消费同一个订阅，同一条消息可能已经被其他实例投递过多次，到当前实例处理时DeliveryCount已经≥5，会直接触发你代码里的死信逻辑。
  解决方法：检查订阅的消费者数量，确认没有多余的消费进程在运行。

内容的提问来源于stack exchange，提问作者OguzKaanAkyalcin