Azure App Configuration更新值无法立即同步至AppSettings的问题咨询

我开发了一个.NET WebAPI应用，集成Azure App Configuration并配置了Sentinel Key实现自动刷新，缓存过期时间设置为5秒。实际运行时出现以下问题：

• 初始键demokey值为1，请求返回new AppSettings().demoKey = 1
• 在Azure App Configuration中更新demokey为2并更新Sentinel Key触发变更
• 等待5秒后发起第一个请求，仍获取旧值1；请求结束后系统才检测到Sentinel Key变更并重新加载配置
• 第二个请求才能获取到新值2

期望行为是：更新配置后，首次发起的请求就能直接获取到更新后的demokey值（2）。

原因分析 #

默认情况下，Azure App Configuration的自动刷新逻辑是在请求生命周期结束后触发后台检测，或依赖缓存过期后的被动刷新，不会在请求处理前主动检查配置变更并加载新值，导致第一个请求仍使用旧缓存。

解决方案 #

方案1：请求前置主动触发配置刷新 #

通过自定义中间件，在请求进入处理流程前主动检查并刷新配置，确保当前请求使用最新值。

1. 确认基础配置（Program.cs）

确保已正确注册Azure App Configuration及自动刷新逻辑：

var builder = WebApplication.CreateBuilder(args);

// 集成Azure App Configuration
builder.Configuration.AddAzureAppConfiguration(options =>
{
    options.Connect(builder.Configuration["AzureAppConfigConnectionString"])
           .ConfigureRefresh(refresh =>
           {
               refresh.Register("SentinelKey", refreshAll: true)
                      .SetCacheExpiration(TimeSpan.FromSeconds(5));
           });
});

// 绑定配置类，使用支持实时更新的注入方式
builder.Services.Configure<AppSettings>(builder.Configuration);
builder.Services.AddAzureAppConfiguration();

2. 编写配置刷新中间件

public class AppConfigRefreshMiddleware
{
    private readonly RequestDelegate _next;
    private readonly IConfigurationRefresher _refresher;

    public AppConfigRefreshMiddleware(RequestDelegate next, IConfigurationRefresherProvider refresherProvider)
    {
        _next = next;
        _refresher = refresherProvider.Refreshers.First();
    }

    public async Task InvokeAsync(HttpContext context)
    {
        // 主动触发刷新：缓存过期时才会真正拉取新配置
        await _refresher.TryRefreshAsync();
        
        // 继续执行后续请求流程
        await _next(context);
    }
}

// 扩展方法简化中间件注册
public static class AppConfigRefreshMiddlewareExtensions
{
    public static IApplicationBuilder UseAppConfigRefresh(this IApplicationBuilder builder)
    {
        return builder.UseMiddleware<AppConfigRefreshMiddleware>();
    }
}

3. 启用中间件（Program.cs）

将刷新中间件放在请求管道的靠前位置，确保所有请求处理前都执行配置检查：

var app = builder.Build();

// 前置配置刷新中间件
app.UseAppConfigRefresh();

// 其他常规中间件配置
app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

方案2：使用IOptionsMonitor实时获取配置 #

在控制器中使用IOptionsMonitor<AppSettings>替代IOptions<AppSettings>，它会自动监听配置变更，实时更新实例值：

[ApiController]
[Route("[controller]")]
public class DemoController : ControllerBase
{
    private readonly IOptionsMonitor<AppSettings> _settingsMonitor;

    public DemoController(IOptionsMonitor<AppSettings> settingsMonitor)
    {
        _settingsMonitor = settingsMonitor;
    }

    [HttpGet]
    public IActionResult Get()
    {
        // 直接获取最新配置值
        var currentValue = _settingsMonitor.CurrentValue.demoKey;
        return Ok($"new AppSettings().demoKey = {currentValue}");
    }
}

关键注意点 #

• TryRefreshAsync()仅在缓存过期时触发刷新，不会无意义地请求Azure App Configuration，性能影响极小；如果需要强制刷新（忽略缓存时间），可改用RefreshAsync()，但会增加请求延迟，需按需使用。
• 两种方案结合使用，可最大化保证配置的实时性与请求性能。

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