Microsoft.FeatureManager无法读取带Label的Azure App Configuration特征标志

问题原因与解决方案 #

1. 带Label的特征标志无法被检索的问题 #

根本原因

.NET Azure Feature Management 组件默认只会加载**无Label（Label值为null）**的特征标志，你未在服务注册阶段配置需要加载的Label范围，因此带Label的特征标志不会被同步到本地Feature Manager缓存中，调用GetFeatureNamesAsync()自然无法返回这类标志。

解决方法

在注册Azure App Configuration服务的代码中，明确指定要拉取的Feature Flags的Label范围，示例代码如下：

// .NET 6+ Program.cs 示例
var builder = WebApplication.CreateBuilder(args);
builder.Configuration.AddAzureAppConfiguration(options =>
{
    options.Connect(builder.Configuration.GetConnectionString("AzureAppConfigConnection"))
           .UseFeatureFlags(flagOptions =>
           {
               // 优先级1：加载所有无Label的特征标志
               flagOptions.Select(KeyFilter.Any, LabelFilter.Null);
               // 优先级2：加载所有Label为自定义值的特征标志，同名标志会覆盖上一条规则的结果
               flagOptions.Select(KeyFilter.Any, "你实际使用的Label值");
               // 若需临时加载所有Label的标志可使用以下配置，不推荐生产环境使用
               // flagOptions.Select(KeyFilter.Any, LabelFilter.Any);

               // 可选：调整缓存过期时间，默认30秒
               flagOptions.CacheExpirationInterval = TimeSpan.FromMinutes(5);
           });
});

// 注册Feature Manager服务（如果未添加需要补全）
builder.Services.AddFeatureManagement();

你贴出的FeatureFlagManager和接口代码本身没有逻辑问题，调整服务注册配置后即可正常获取带Label的特征标志。

2. 已创建的特征标志无法编辑Label的问题 #

Azure App Configuration中，特征标志的Key + Label是联合唯一主键，Label作为主键的组成部分，创建后不支持修改。如果需要调整Label，可删除原有标志后重新创建，或者使用Azure门户的「复制」功能，复制原有标志配置后修改Label再保存即可。

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