Aspire集成Azure Service Bus时连接字符串读取失败排查求助

核心问题1：App Host未配置连接字符串 #

你的App Host项目调用builder.AddConnectionString("Messaging")时，会从App Host自身的配置源（如appsettings.json、环境变量等）读取该连接字符串，而非消费项目的配置。目前你仅在组件消费项目的appsettings.json中配置了ConnectionStrings:Messaging，导致App Host找不到对应值，抛出connection string 'Messaging' is missing错误。

解决方法 #

将ConnectionStrings:Messaging配置添加到App Host项目的appsettings.json中：

"ConnectionStrings": {
  "Messaging": "Endpoint=sb://somenamespace.servicebus.windows.net/;SharedAccessKeyName=Manage;SharedAccessKey=someaccesskey"
}

注意：需移除连接字符串中的EntityPath=topic1参数，理由见下文。

核心问题2：连接字符串包含多余的EntityPath参数 #

Aspire的AddAzureServiceBusClient组件要求连接字符串为Service Bus命名空间级别的连接字符串，不能包含EntityPath（该参数用于指定具体主题/队列）。当连接字符串包含EntityPath时，Aspire的配置验证逻辑会失败，引发Failed to apply configuration value 'ConnectionStrings__Messaging'错误。

解决方法 #

• 从连接字符串中删除;EntityPath=topic1部分，仅保留命名空间级连接字符串。
• 在消费项目中使用客户端时，明确指定实体路径：

  // 发送消息到topic1示例
  await serviceBusSender.SendMessageAsync(new ServiceBusMessage("test"), "topic1");
  // 或创建针对特定实体的客户端
  var sender = client.CreateSender("topic1");
  

额外验证步骤 #

• 确保App Host和消费项目安装了正确的Aspire包：
  • 消费项目：Aspire.Microsoft.Azure.ServiceBus
  • App Host项目：Aspire.Hosting
• 确认App Host的配置源（如环境变量）未覆盖ConnectionStrings:Messaging的值。
• 重启App Host项目，检查Aspire仪表板日志是否仍存在错误。

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