基于eShopContainer EventBus的C#控制台应用如何订阅Azure Event Grid获取队列消息
C# 控制台应用基于队列存储端点订阅Azure Event Grid并获取消息实现方案
场景背景
当前正在落地eShopContainer项目的EventBus示例,需要完成的功能目标为:
- 为指定Azure Event Grid Topic创建关联订阅
- 持续监听Topic下的消息流转
- 处理并打印另一同基于EventBus实现的C#控制台应用此前发送的历史消息
当前运行环境下所有Event Grid流转的消息均存储在Queue Storage中,Azure门户侧的订阅投递规则、队列资源配置已对齐既定的参考配置要求。
前置准备
在控制台项目中通过NuGet引入以下必要依赖:
Azure.Messaging.EventGrid:负责Event Grid的订阅管理、基础元数据交互Azure.Storage.Queues:负责对接承载Event Grid消息的Azure队列存储
提前从Azure门户获取三类必要配置值:- Event Grid Topic的服务访问地址、对应的访问密钥
- 承载消息的存储账户连接字符串
- 关联Event Grid订阅的队列名称
分步骤实现
1. 创建队列存储端点的Event Grid订阅
通过SDK调用Event Grid的订阅创建接口,直接将消息投递目标指定为已配置的Queue Storage,不需要额外搭建公网可访问的Webhook接收端点,核心代码参考:
// 初始化Event Grid Topic管理客户端 var topicUri = new Uri("<你的Event Grid Topic完整服务地址>"); var egClient = new EventGridPublisherClient(topicUri, new Azure.AzureKeyCredential("<你的Topic访问密钥>")); // 为Topic创建订阅,指定投递目标为队列存储 await egClient.CreateSubscriptionAsync( new SubscriptionProperties("queue-sub-demo") { Destination = new StorageQueueEventSubscriptionDestination() { ResourceId = "<你的存储队列资源ID>", QueueName = "<承载消息的队列名称>" } });
配置提示:创建订阅时的过滤规则、投递重试策略需要和Azure门户中已配置的规则保持一致,避免出现消息无法正常投递到队列的问题。
2. 拉取队列中存储的全量历史消息
由于Event Grid投递的所有消息都会直接落到关联的Queue Storage中,直接通过队列存储SDK拉取消息即可获取所有此前发送的历史内容,不需要额外对接Event Grid的主动拉取接口,核心代码参考:
// 初始化队列客户端 var queueClient = new QueueClient("<你的存储账户连接字符串>", "<承载消息的队列名称>"); await queueClient.CreateIfNotExistsAsync(); // 批量拉取队列中的历史消息 var messages = queueClient.ReceiveMessages(maxMessages: 32, visibilityTimeout: TimeSpan.FromSeconds(30)); foreach (var queueMsg in messages) { // 解析消息内容并打印 Console.WriteLine($"接收到历史消息:{queueMsg.MessageText}"); // 业务处理完成后删除队列消息,避免重复消费 await queueClient.DeleteMessageAsync(queueMsg.MessageId, queueMsg.PopReceipt); }
3. 实现实时消息监听
如果需要持续接收后续新产生的消息,可以在控制台应用中加入固定间隔的轮询逻辑,按照5-10秒的间隔循环拉取队列中的新消息,不需要长时间占用公网端口,完全适配控制台应用的运行形态。
常见排查方向
- 若无法拉取到历史消息,优先核对代码中访问的队列是否和Event Grid订阅的投递目标队列完全一致,注意队列名称的大小写匹配
- 若消息解析失败,需要注意Event Grid投递到队列的消息外层会带统一的信封结构,需要先解包信封再反序列化实际业务消息内容
- 若出现消息重复消费,需要合理设置消息的可见性超时时间,在业务处理完成后及时触发队列消息删除操作
内容的提问来源于stack exchange,提问作者Ángel García
相关产品推荐
相关产品推荐

