Azure App Service中Blazor Server配置变更的通知与实时获取方案问询

页面注入IConfiguration的取值逻辑 #

默认情况下，ASP.NET Core的IConfiguration是启动时加载的配置快照，Azure App Service的环境属性（应用设置）作为环境变量被读取后，不会自动监听变更。因此：

• 页面每次加载时注入的IConfiguration，依然是启动时的旧值，不会自动获取最新配置。
• 必须手动触发配置刷新，或配置自动重载机制，才能拿到更新后的值。

配置刷新的实现方式 #

1. 手动触发配置刷新 #

IConfiguration本质是IConfigurationRoot的抽象，你可以通过强制调用Reload()方法刷新配置：
首先在Program.cs中保留IConfigurationRoot的引用：

var builder = WebApplication.CreateBuilder(args);
var configRoot = builder.Configuration as IConfigurationRoot;

然后添加一个用于触发刷新的内部API端点：

app.MapGet("/internal/refresh-config", () =>
{
    configRoot?.Reload();
    return Results.Ok("配置已刷新");
});

当你在Azure App Service修改完环境属性后，调用这个端点，后续读取IConfiguration就能拿到最新值。

2. 使用IOptionsMonitor自动感知变更 #

推荐使用IOptionsMonitor<T>替代直接注入IConfiguration，它能自动监听配置变更并返回最新值，无需手动刷新。

步骤1：定义配置类

public class AppEnvSettings
{
    // 对应Azure App Service中的环境属性键名
    public string ApiBaseUrl { get; set; } = string.Empty;
    public string ConnectionString { get; set; } = string.Empty;
}

步骤2：注册配置绑定

在Program.cs中绑定配置节：

builder.Services.Configure<AppEnvSettings>(builder.Configuration);

步骤3：在页面或服务中注入使用

在Blazor页面：

[Inject]
protected IOptionsMonitor<AppEnvSettings> EnvSettingsMonitor { get; set; } = default!;

// 获取最新值
var latestApiUrl = EnvSettingsMonitor.CurrentValue.ApiBaseUrl;

// 监听配置变更事件
protected override void OnInitialized()
{
    EnvSettingsMonitor.OnChange(settings =>
    {
        // 配置变更时执行的逻辑，比如更新页面状态
        StateHasChanged();
    });
}

在作用域服务的构造函数中注入：

public class MyScopedService
{
    private readonly IOptionsMonitor<AppEnvSettings> _settingsMonitor;

    public MyScopedService(IOptionsMonitor<AppEnvSettings> settingsMonitor)
    {
        _settingsMonitor = settingsMonitor;
    }

    public void DoWork()
    {
        // 每次调用都获取最新配置值
        var latestConnStr = _settingsMonitor.CurrentValue.ConnectionString;
    }
}

注意事项 #

• Azure App Service修改环境属性后无需重启应用，但ASP.NET Core默认不会主动感知，必须通过上述机制触发刷新或使用IOptionsMonitor。
• IOptionsSnapshot<T>也能获取最新配置，但它是作用域生命周期，适合在作用域服务中使用；IOptionsMonitor<T>是单例，支持跨作用域监听变更，更适配Blazor Server场景。

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