Blazor Server应用如何实现本地配置覆盖Azure App Config指定配置项

最优实现方案 #

.NET 配置系统默认遵循后注册的配置源优先级更高的规则，你只需要调整配置源的注册顺序，仅在开发环境下将允许覆盖的本地配置源注册到Azure App Configuration之后即可，不需要全量复刻CreateDefaultBuilder的逻辑，也不会影响生产环境的默认配置优先级。

修改后的代码示例

仅需要调整ConfigureAppConfiguration部分的逻辑，在Azure配置源注册完成后追加开发环境本地覆盖源即可：

.ConfigureAppConfiguration((hostingContext, config) =>
{
    var settings = config.Build();
    var credentials = new DefaultAzureCredential(false);
    config.AddAzureAppConfiguration(options =>
    {
        var azAppConfigurationURI = settings.GetValue<string>("AzAppConfigurationURI");
        var envName = hostingContext.HostingEnvironment.EnvironmentName;

        options.Connect("Endpoint = end + key ") // 实际使用时替换为正常连接逻辑
        .ConfigureKeyVault(kv =>
        {
            kv.SetCredential(credentials);
        })
        .ConfigureRefresh(refresh =>
        {
            refresh.Register("test", refreshAll: true)
            .SetCacheExpiration(new TimeSpan(0, 1, 0));
        })                        
       .UseFeatureFlags((featureFlagOptions =>
       {
           featureFlagOptions.Label = envName;
           featureFlagOptions.CacheExpirationInterval = TimeSpan.FromMinutes(5);                           
       }));
    });

    // 仅开发环境添加本地覆盖配置，优先级高于Azure App Configuration
    if (hostingContext.HostingEnvironment.IsDevelopment())
    {
        // 加载开发环境配置文件覆盖云端
        config.AddJsonFile("appsettings.Development.json", optional: true, reloadOnChange: true);
        // 可选：添加用户机密，开发人员私有配置不会提交到代码库
        config.AddUserSecrets<Program>(optional: true);
        // 可选：如果需要环境变量也覆盖云端配置，可放开下方注释
        // config.AddEnvironmentVariables();
    }
})

如果是.NET 5及更早版本，项目入口为Startup类，将AddUserSecrets<Program>替换为AddUserSecrets<Startup>即可。

方案优势

1. 完全匹配需求：开发人员仅需要在本地配置文件/用户机密中填写要修改的配置项即可覆盖云端，其余未修改的配置仍然从Azure App Configuration读取
2. 无侵入性：生产环境逻辑完全不变，仍然保持云端配置覆盖本地的默认规则，符合生产场景要求
3. 实现简单：不需要修改原有Azure配置的加载逻辑，也不需要重写默认构造器的配置加载流程
4. 安全性高：支持用户机密作为覆盖源，避免开发人员的本地测试配置不小心提交到代码仓库造成泄露

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