ASP.NET Core 6中IFeatureManager缓存过期后首次调用为何未刷新？

你遇到的问题源于Azure App Configuration功能标志默认的缓存刷新逻辑：缓存过期后，首次请求会先返回旧缓存值，后台异步完成缓存刷新，因此第二次请求才能拿到更新后的标志值。可以通过以下两种方案解决：

方案1：修改缓存刷新模式，主动提前刷新 #

在配置Feature Flags时，设置RefreshMode.RefreshBeforeCacheExpiration，让应用在缓存过期前主动刷新，避免首次请求返回旧值：

builder.Configuration.AddAzureAppConfiguration(options =>
{
    options.UseFeatureFlags(opts =>
    {
        opts.CacheExpirationInterval = TimeSpan.FromSeconds(5);
        // 配置为缓存过期前主动刷新，确保新值及时可用
        opts.RefreshMode = Azure.Core.Extensions.RefreshMode.RefreshBeforeCacheExpiration;
        // 可选：设置缓存过期前的刷新窗口，比如提前1秒开始刷新
        opts.CacheExpirationWindow = TimeSpan.FromSeconds(1);
    });
});

方案2：启用即时刷新（Push Refresh） #

如果需要更实时的更新响应，可以配置即时刷新，当Azure App Configuration中的功能标志变更时，主动通知应用刷新缓存，无需等待缓存过期：

配置代码示例 #

builder.Configuration.AddAzureAppConfiguration(options =>
{
    options.Connect("你的Azure App Configuration连接字符串")
           .UseFeatureFlags(opts =>
           {
               opts.CacheExpirationInterval = TimeSpan.FromSeconds(30); // 设置较长缓存作为降级方案
           })
           // 注册功能标志的刷新触发器，监听所有FeatureManagement前缀的配置变更
           .ConfigureRefresh(refreshOpts =>
           {
               refreshOpts.Register("FeatureManagement:*", refreshAll: true)
                          .SetCacheExpiration(TimeSpan.FromSeconds(5));
           });
});

注意事项 #

• 确保已正确添加app.UseAzureAppConfiguration();中间件，它会处理即时刷新的通知并自动更新缓存
• 若使用Managed Identity访问Azure App Configuration，需确保应用服务的身份有对应的读取权限

额外验证点 #

• 确认IFeatureManager是通过依赖注入获取的（默认是Scoped生命周期，每次请求会获取能读取最新缓存的实例）
• 如果在单例服务中使用功能标志，建议改用IFeatureManagerSnapshot来获取实时值

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