.NET中CloudQueueClient与QueueClient类的区别及适用场景咨询

.NET对接Azure队列存储提供的两个客户端类分属新旧两代Azure SDK体系，具体差异和适用场景整理如下：

核心差异 #

• 代际与维护状态不同
  CloudQueueClient 属于旧版（Legacy）Azure存储SDK，对应命名空间Microsoft.Azure.Storage.Queue，目前已经进入维护冻结状态，官方仅推送严重安全问题修复补丁，不再新增任何功能。QueueClient 属于微软2019年后重构的Track2新版Azure SDK，对应命名空间Azure.Storage.Queues，是当前官方推荐的正式客户端，所有队列存储的新特性都会优先在这个版本迭代。
• API设计与生态适配不同
  旧版CloudQueueClient采用同步优先的传统API设计，全局配置耦合在客户端实例中，自定义重试策略、拦截逻辑的灵活度很低，底层基于老旧的HttpWebRequest实现，性能表现一般，也不支持.NET Core生态原生的依赖注入模式。新版QueueClient采用异步优先的API设计，所有核心IO操作都提供标准的异步方法，客户端构造支持依赖注入，重试规则、鉴权逻辑、序列化配置都可以通过独立的Options类灵活自定义，底层基于HttpClient实现，高并发场景下的内存占用、吞吐量表现比旧版高30%以上，和其他Azure服务新版SDK（比如服务总线、Blob存储、密钥保管库）的配置逻辑、使用范式完全统一。
• 能力与鉴权支持不同
  CloudQueueClient仅覆盖队列基础管理、消息收发的核心能力，鉴权仅支持存储连接字符串、账户密钥、共享访问签名（SAS）三种方式。QueueClient除了兼容旧版所有基础能力外，额外支持消息批量收发、消息可见超时动态调整、细粒度队列访问策略配置等能力，鉴权层面原生支持Azure AD托管标识、服务主体、RBAC角色权限管控，不需要硬编码存储密钥即可完成权限校验，更适配云上合规部署要求。

适用场景 #

优先选择 QueueClient 的场景 #

• 所有新启动的.NET项目，包括基于.NET Core/.NET 5+、.NET Framework 4.6.1及以上版本的系统
• 部署在Azure云上、需要使用托管标识实现无密钥鉴权的场景
• 高并发消息处理、对客户端性能和资源占用有明确要求的场景
• 需要长期迭代、后续会用到队列存储新增特性的项目

仅推荐使用 CloudQueueClient 的场景 #

• 已经基于旧版SDK完成全量开发、短期内没有重构排期的存量项目
• 系统运行环境为.NET Framework 4.6.1以下版本、无法升级运行时的老旧系统

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