Azure生产/测试环境中，如何从appsettings.json读取Service Bus触发配置

1. 确保配置文件随部署包发布 #

修改项目的.csproj文件，添加以下配置，让appsettings.json和对应环境的配置文件（比如appsettings.Staging.json、appsettings.Production.json）被复制到输出目录，确保部署到Azure时能带上这些文件：

<ItemGroup>
  <None Update="appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
  <None Update="appsettings.Staging.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
  <None Update="appsettings.Production.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

2. 在Azure门户设置运行环境 #

进入Azure函数应用的配置 -> 应用设置，添加名为ASPNETCORE_ENVIRONMENT的设置，值根据环境填Staging或Production，这样函数会自动加载对应的环境配置文件。

3. 自定义配置加载逻辑 #

根据你的函数运行模型（隔离进程/In-Process）修改配置加载代码：

隔离进程模型（.NET 6+推荐）

修改Program.cs，在构建主机时添加appsettings.json的配置源：

var host = new HostBuilder()
    .ConfigureAppConfiguration((context, config) =>
    {
        var env = context.HostingEnvironment;
        // 加载基础配置和对应环境的配置
        config.AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
              .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true, reloadOnChange: true)
              .AddEnvironmentVariables(); // 保留环境变量优先级，方便用Azure应用设置临时覆盖
    })
    .ConfigureFunctionsWorkerDefaults()
    .Build();

host.Run();

In-Process模型（.NET 5及以前）

创建Startup.cs（如果没有的话），继承FunctionsStartup并配置配置源：

using Microsoft.Azure.Functions.Extensions.DependencyInjection;
using Microsoft.Extensions.Configuration;
using System.IO;

[assembly: FunctionsStartup(typeof(YourNamespace.Startup))]
namespace YourNamespace
{
    public class Startup : FunctionsStartup
    {
        public override void ConfigureAppConfiguration(IFunctionsConfigurationBuilder builder)
        {
            var context = builder.GetContext();
            builder.ConfigurationBuilder
                .AddJsonFile(Path.Combine(context.ApplicationRootPath, "appsettings.json"), optional: true, reloadOnChange: true)
                .AddJsonFile(Path.Combine(context.ApplicationRootPath, $"appsettings.{context.EnvironmentName}.json"), optional: true, reloadOnChange: true)
                .AddEnvironmentVariables();
        }
    }
}

4. 配置优先级说明 #

• 最后添加的AddEnvironmentVariables()会让Azure应用设置（环境变量）的优先级高于appsettings.json中的配置，这样你可以在Azure门户临时调整配置，不用重新部署。
• 你原有的ServiceBusTrigger中的%DocUploadQueueName%和%DocUploadAzureServiceBusConnectionString%会自动从配置系统读取，不管配置来自appsettings还是Azure应用设置。

5. 部署后验证 #

部署完成后，通过Azure函数应用的高级工具(Kudu) -> 调试控制台 -> CMD，进入wwwroot目录，确认appsettings系列文件存在；然后测试函数是否能正常接收Service Bus消息，验证配置加载是否生效。

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