使用Microsoft Feature Management，如何不重启应用更新配置文件中的Feature Flags？

问题背景 #

通过Microsoft Feature Management实现功能开关，配置从JSON文件（含secrets.json）加载，后端用IFeatureManager检查开关，前端通过控制器获取IOptions<CompanyOptions>使用。修改secrets.json后，前后端开关均无法动态更新，涉及场景包括：

• Startup中根据开关注册的处理器
• 业务类中对开关的使用
• 控制器上的[FeatureGate]属性
• 前端TypeScript从控制器获取CompanyOptions并存为静态变量的场景
  尝试过IOptionsSnapshot和IOptionsMonitor但无效，需无需重启应用的动态更新方案。

后端动态更新方案 #

1. 修复配置源重载逻辑 #

你的SetupConfiguration已为JSON文件设置reloadOnChange: true，但需移除多余的config.Build()调用——提前构建配置会导致后续变更无法被感知，Host会自动处理配置构建流程。

修改Program.cs的ConfigureAppConfiguration段：

public static IHostBuilder CreateHostBuilder(string[] args)
    => Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((hostingContext, config) =>
        {
            SetupConfiguration(config, hostingContext.HostingEnvironment);
            if (hostingContext.HostingEnvironment.IsDevelopment())
            {
                config.AddUserSecrets<Startup>();
            }
            // 移除此处的config.Build()
        })
        ...
        .ConfigureServices((context, services) =>
        { 
            services.AddFeatureManagement(context.Configuration.GetSection("Company:FeatureFlags"));
        });

2. 确保IFeatureManager实时获取配置 #

Microsoft Feature Management默认支持配置动态更新，需注意：

• 不要在类构造函数中缓存开关状态，每次判断时直接调用featureManager.IsEnabledAsync("FeatureName")
• 控制器上的[FeatureGate]属性会在每次请求时重新检查开关，无需额外配置即可感知变更

3. 动态切换Startup注册的处理器 #

Startup仅在应用启动时执行，无法直接动态修改已注册服务，需通过工厂模式实现：

• 定义处理器接口与多实现类
• 注册工厂类，注入IFeatureManager和IServiceProvider，每次根据当前开关状态返回对应处理器
• 业务类注入工厂类而非直接注入处理器实例

示例代码：

// 处理器接口与实现
public interface IProcessor { void Process(); }
public class ProcessorA : IProcessor { /* 业务实现 */ }
public class ProcessorB : IProcessor { /* 业务实现 */ }

// 处理器工厂
public class ProcessorFactory
{
    private readonly IFeatureManager _featureManager;
    private readonly IServiceProvider _serviceProvider;

    public ProcessorFactory(IFeatureManager featureManager, IServiceProvider serviceProvider)
    {
        _featureManager = featureManager;
        _serviceProvider = serviceProvider;
    }

    public async Task<IProcessor> GetCurrentProcessorAsync()
    {
        return await _featureManager.IsEnabledAsync("UseProcessorB")
            ? _serviceProvider.GetRequiredService<ProcessorB>()
            : _serviceProvider.GetRequiredService<ProcessorA>();
    }
}

// Startup注册逻辑
services.AddTransient<IProcessor, ProcessorA>();
services.AddTransient<IProcessor, ProcessorB>();
services.AddTransient<ProcessorFactory>();

// 业务类使用方式
public class BusinessService
{
    private readonly ProcessorFactory _factory;

    public BusinessService(ProcessorFactory factory)
    {
        _factory = factory;
    }

    public async Task DoWorkAsync()
    {
        var processor = await _factory.GetCurrentProcessorAsync();
        processor.Process();
    }
}

4. 让CompanyOptions支持实时更新 #

使用IOptionsMonitor<CompanyOptions>替代IOptions/IOptionsSnapshot，它会主动监听配置变更并推送最新值。修改控制器代码：

[ApiController]
[Route("api/settings")]
public class SettingsController : ControllerBase
{
    private readonly IOptionsMonitor<CompanyOptions> _optionsMonitor;

    public SettingsController(IOptionsMonitor<CompanyOptions> optionsMonitor)
    {
        _optionsMonitor = optionsMonitor;
    }

    [HttpGet]
    public IActionResult Get()
    {
        return Ok(_optionsMonitor.CurrentValue);
    }
}

前端动态更新方案 #

前端静态缓存CompanyOptions会导致无法感知后端变更，需：

• 移除静态变量缓存，每次使用开关时实时调用后端接口获取最新配置
• 可选：实现轮询机制（如每30秒请求一次）定期更新本地配置
• 可选：用SignalR实现后端主动推送配置变更，做到实时更新

示例TypeScript轮询代码：

let companyOptions: CompanyOptions | null = null;

// 定义获取配置的方法
async function fetchCompanyOptions(): Promise<CompanyOptions> {
    const response = await fetch('/api/settings');
    return await response.json();
}

// 初始化+轮询更新
async function initSettings() {
    companyOptions = await fetchCompanyOptions();
    setInterval(async () => {
        companyOptions = await fetchCompanyOptions();
    }, 30000); // 每30秒更新一次
}

// 使用时直接读取最新值
function checkFeatureFlag(featureName: string): boolean {
    return companyOptions?.FeatureFlags[featureName] ?? false;
}

验证步骤 #

1. 修改secrets.json中的Feature Flags值
2. 等待2-3秒（配置源重载有轻微延迟）
3. 后端验证：
   • 调用使用IFeatureManager的接口，检查开关状态是否更新
   • 访问带[FeatureGate]的控制器，验证访问权限是否变更
   • 调用业务接口，验证处理器是否切换
4. 前端验证：
   • 查看页面开关功能是否更新，或等待轮询触发后确认

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