Blazor应用可加载Azure App Config配置但无法读取功能标志值

常见触发原因 #

• 功能标志读取代码未正确等待异步执行，使用.Result在Blazor同步上下文下可能出现未完成查询就返回默认值的问题
• Azure App Config中创建的功能标志设置了自定义标签，默认UseFeatureFlags()仅拉取无标签的功能标志
• 配置拉取时添加了自定义过滤规则，未包含功能标志默认前缀.appconfig.featureflag/*，导致功能标志配置被过滤未拉取到本地
• 刚修改功能标志状态未过缓存周期，默认功能标志缓存时间为30秒，缓存未过期时不会拉取最新状态
• 功能标志配置了自定义功能过滤器但参数配置错误，导致判断逻辑返回false

排查步骤 #

1. 先验证功能标志配置是否已拉取到本地，在任意可注入IConfiguration的位置输出如下值，确认是否能读到内容：

// 功能标志默认配置键格式
Console.WriteLine(Configuration[".appconfig.featureflag/OreNoFlaggu"]);

• 若读不到值：问题出在配置拉取环节，走下一步排查
• 若能读到值：问题出在功能标志判断逻辑，直接跳至步骤3

2. 配置拉取环节排查
   • 检查Azure Portal中该功能标志的键名是否完全匹配OreNoFlaggu，是否设置了自定义标签
   • 检查Program.cs中AddAzureAppConfiguration的配置是否添加了Select过滤规则，是否包含功能标志前缀
   • 确认当前应用身份（密钥/托管身份）拥有App Configuration Data Reader权限（普通配置能拉取通常权限无问题）
3. 功能标志逻辑排查
   • 检查Azure Portal中该功能标志是否配置了自定义过滤器，暂时移除所有过滤器仅保留基础启用状态测试
   • 检查是否自定义了功能管理配置节的前缀，默认AddFeatureManagement()读取的是FeatureManagement配置节

修复方案 #

1. 修正功能标志读取代码，移除.Result改用正确的异步等待：

protected override async Task OnInitializedAsync()
{
    featureEnabled = await featureManager.IsEnabledAsync("OreNoFlaggu");
}

2. 若功能标志设置了自定义标签，调整UseFeatureFlags配置指定对应标签，可同步缩短缓存周期方便测试：

config.AddAzureAppConfiguration(options =>
    options.Connect(connection)
           .UseFeatureFlags(f => 
           {
               f.Label = "你设置的功能标志标签名"; // 无标签可省略该行
               f.CacheExpirationInterval = TimeSpan.FromSeconds(5);
           }));

3. 若配置了自定义拉取过滤规则，添加功能标志前缀的拉取规则：

config.AddAzureAppConfiguration(options =>
    options.Connect(connection)
           .Select("你的普通配置前缀:*") // 保留原有的普通配置过滤规则
           .Select(".appconfig.featureflag/*") // 新增功能标志拉取规则
           .UseFeatureFlags());

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