独立模式Azure Function访问Azure Service Bus失败求助

问题背景 #

独立模式的Azure Function使用ServiceBusTrigger，本地运行正常，但部署到Azure后无法启动监听器，报错找不到AzureServiceBus:ConnectionString连接字符串，同时疑惑为何运行时会引用Microsoft.Azure.WebJobs.Extensions.ServiceBus。

相关代码与配置 #

Function代码 #

[Function("Function1")]
public async Task Run([ServiceBusTrigger("email", Connection = "AzureServiceBus:ConnectionString")] string myQueueItem, CancellationToken cancellationToken)        
{
}

appsettings.json配置 #

"AzureServiceBus": {
    "ConnectionString": "Endpoint=sb://"
}

Program.cs代码 #

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureAppConfiguration(builder =>
    {
        builder.AddJsonFile("local.settings.json");
        builder.AddJsonFile("appsettings.json");
        builder.AddUserSecrets<Program>();
    })    
    .ConfigureServices((context, services) => 
    {                
        services.Configure<AzureServiceBus>(context.Configuration.GetSection("AzureServiceBus"));
    })
    .Build();

host.Run();

使用的NuGet包 #

Microsoft.Azure.Functions.Worker.Extensions.ServiceBus (5.11)

报错信息 #

The listener for function 'Functions.Function1' was unable to start.
Service Bus account connection string
'AzureServiceBus:ConnectionString' does not exist. Make sure that it
is a defined App Setting.
Microsoft.Azure.WebJobs.Extensions.ServiceBus.Config.ServiceBusClientFactory.ResolveConnectionInformation

完整栈跟踪：

Microsoft.Azure.WebJobs.Host.Listeners.FunctionListenerException:
System.InvalidOperationException:
   at Microsoft.Azure.WebJobs.Extensions.ServiceBus.Config.ServiceBusClientFactory.ResolveConnectionInformation (Microsoft.Azure.WebJobs.Extensions.ServiceBus, Version=5.11.0.0, Culture=neutral, PublicKeyToken=92742159e12e44c8)
   at Microsoft.Azure.WebJobs.Extensions.ServiceBus.Config.ServiceBusClientFactory.CreateClientFromSetting (Microsoft.Azure.WebJobs.Extensions.ServiceBus, Version=5.11.0.0, Culture=neutral, PublicKeyToken=92742159e12e44c8)
   at System.Lazy`1.ViaFactory (System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e)
   at System.Lazy`1.ExecutionAndPublication (System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e)
   at System.Lazy`1.CreateValue (System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e)
   at Microsoft.Azure.WebJobs.ServiceBus.Listeners.ServiceBusListener+<>c__DisplayClass33_0.<.ctor>b__2 (Microsoft.Azure.WebJobs.Extensions.ServiceBus, Version=5.11.0.0, Culture=neutral, PublicKeyToken=92742159e12e44c8)
   at System.Lazy`1.ViaFactory (System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e)
   at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw (System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e)
   at System.Lazy`1.CreateValue (System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e)
   at Microsoft.Azure.WebJobs.ServiceBus.Listeners.ServiceBusListener+<StartAsync>d__34.MoveNext (Microsoft.Azure.WebJobs.Extensions.ServiceBus, Version=5.11.0.0, Culture=neutral, PublicKeyToken=92742159e12e44c8)
   at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw (System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e)
   at System.Runtime.CompilerServices.TaskAwaiter.ThrowForNonSuccess (System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e)
   at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification (System.Private.CoreLib, Version=6.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e)
   at Microsoft.Azure.WebJobs.Host.Listeners.FunctionListener+<StartAsync>d__13.MoveNext (Microsoft.Azure.WebJobs.Host, Version=3.0.37.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35: D:\a\_work\1\s\src\Microsoft.Azure.WebJobs.Host\Listeners\FunctionListener.cs:68)

关键分析 #

1. 为何出现Microsoft.Azure.WebJobs.Extensions.ServiceBus？
   Microsoft.Azure.Functions.Worker.Extensions.ServiceBus是独立模式（Isolated Worker）的ServiceBus扩展包，它底层依赖传统的Microsoft.Azure.WebJobs.Extensions.ServiceBus包实现ServiceBus客户端的创建与管理，运行时加载该依赖是正常设计，并非错误。

2. 部署后找不到连接字符串的原因
   Azure Function App云端环境默认优先从**应用程序设置（App Settings）**读取配置，而非本地appsettings.json：

• 本地运行时，配置加载逻辑会读取appsettings.json，因此能找到连接字符串；
• 云端环境中，未将AzureServiceBus:ConnectionString配置添加到Azure应用设置；
• Azure App Settings识别分层配置时，需用**双下划线(__)**代替冒号(:)，即键名应为AzureServiceBus__ConnectionString，否则无法解析路径式配置键。

解决方案 #

方案1：添加Azure应用程序设置（推荐） #

1. 登录Azure Portal，找到目标Function App；
2. 进入配置 > 应用程序设置；
3. 添加新设置：
   • 名称：AzureServiceBus__ConnectionString
   • 值：完整的Azure Service Bus连接字符串（从Service Bus命名空间共享访问策略中获取）；
4. 保存设置，Function App自动重启后监听器即可正常启动。

方案2：确保appsettings.json部署到云端（不推荐用于敏感数据） #

若必须用appsettings.json管理配置，需：

1. 确保部署包包含appsettings.json文件；
2. 确认Program.cs的配置加载逻辑在云端环境能正确读取该文件；
3. 注意：不要在appsettings.json中硬编码敏感连接字符串，建议配合Azure Key Vault使用。

额外检查 #

• 确认Service Bus连接字符串至少拥有Listen权限（队列触发场景）；
• 本地与云端使用的连接字符串需一致，避免权限或命名空间错误。

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