Azure Service Bus接收消息异常：无法进入循环且控制台无输出求助

以下是针对问题的排查方向和解决办法：

• 检查订阅过滤规则
  登录Azure门户，找到对应订阅的过滤器配置项。如果设置了自定义过滤条件，可能导致发送到主题的消息被过滤，无法进入订阅。可以临时将过滤器改为True（匹配所有消息），测试是否能正常接收。

• 查看消息状态
  在订阅的消息页面，查看活动消息、锁定的消息、死信消息的数量：

  • 若有锁定的消息，等待锁过期（默认30秒）或手动解锁后重试接收；
  • 若存在死信消息，检查死信原因，排查消息被拒收的问题。

• 调整接收等待时间
  代码中max_wait_time=5设置的是接收者最长等待时间（单位为秒），如果消息在5秒内未到达，接收循环会直接结束。可以将该值调大（如max_wait_time=30），确保有足够时间等待消息。

• 确认SDK版本与代码兼容性
  执行pip show azure-servicebus查看SDK版本：

  • 若使用v7及以上版本，推荐使用receive_messages方法接收消息，修改代码如下：

    with servicebus_client:
        receiver = servicebus_client.get_subscription_receiver(topic_name=TOPIC_NAME, subscription_name=SUBSCRIPTION_NAME)
        with receiver:
            # 单次接收最多10条消息，等待30秒
            received_msgs = receiver.receive_messages(max_wait_time=30, max_message_count=10)
            for msg in received_msgs:
                print("Received: " + str(msg))
                receiver.complete_message(msg)
    

  • 若使用旧版本（v5及以下），确保max_wait_time参数传递正确，且接收逻辑符合对应版本的API规范。

• 验证接收权限
  确认servicebus_client使用的连接字符串或身份凭证，拥有该订阅的Listen权限。自定义SAS政策需明确包含Listen权限，避免因权限不足导致无法读取消息。

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