SuperAPI AI 工具集

azure-servicebus-dotnet

部署与运维

查看项目

更新于 10-16 03:04

技能介绍

用途:面向 .NET 的 Azure Service Bus 企业消息 SDK,实现可靠消息传递,支持队列、主题、订阅与会话。安装命令:dotnet add package Azure.Messaging.ServiceBus 与 dotnet add package Azure.Identity,当前稳定版 v7.20.1。

主要能力:ServiceBusClient 为入口,可创建发送端、接收端、会话接收端、后台处理器与会话处理器;ServiceBusAdministrationClient 用于队列/主题/订阅的增删改查。支持发送单条或安全批量消息(CreateMessageBatchAsync 与 TryAddMessage)、单条或批量接收、消息结算(Complete/Abandon/Defer/DeadLetter)、死信队列读取与元数据、主题订阅广播、会话内有序(FIFO)处理、会话状态管理与锁续期、以及跨实体事务。

用法与配置:可通过环境变量 AZURE_SERVICEBUS_FULLY_QUALIFIED_NAMESPACE 或连接字符串配置;生产推荐 DefaultAzureCredential;ASP.NET Core 可用 AddAzureClients 注入。后台处理建议用 Processor,自动处理锁续期;异常可用 ServiceBusException.Reason 判断;端口被阻止时可改用 AmqpWebSockets。

最佳实践:客户端、发送端、接收端与处理器线程安全,宜作单例;用 await using 及时释放,先释放发送端/接收端/处理器再释放客户端;生产优先 Entra ID 而非连接字符串;默认锁时长为 30 秒,需按场景调整。

适用场景:需要可靠消息投递、广播订阅、顺序会话处理或后台消费的 .NET 应用。

限制:资料未提供定价、平台支持范围及具体性能指标;输出不能替代针对具体环境的验证、测试或专家评审;缺少必要输入、权限、安全边界或成功标准时应先确认。