Azure Function中FeatureManagement无法正常工作的问题求助

我在Azure Function中使用Microsoft.FeatureManagement.AspNetCore NuGet包实现功能管理，但无论修改特性名称（如xxxxxxEnabled或yyyyEnabled），调用IsEnabledAsync时结果始终为false。

使用的NuGet命令： #

dotnet add package Microsoft.FeatureManagement.AspNetCore

配置文件内容： #

{
  "IsEncrypted": false,
  "Values": {
    ...
  },
  "ConnectionStrings": {},
  "FeatureFlags": {
    "xxxEnabled": true
  }
}

Startup.cs 配置： #

builder.Services.AddFeatureManagement(_configuration.GetSection("FeatureFlags"));

调用代码： #

var r = _manager.IsEnabledAsync("xxxEnabled").GetAwaiter().GetResult();
if (await _manager.IsEnabledAsync("xxxEnabled"))
{
   await mymethod(order).ConfigureAwait(false);
}
else
{
  await mymethod2(order).ConfigureAwait(false);
}

请问问题出在哪里？

问题排查与解决方案 #

1. Azure Function 配置读取路径不匹配 #

Azure Function的配置系统默认仅加载local.settings.json中Values节点下的内容，你直接放在根节点的FeatureFlags无法被配置系统正确读取，导致特性管理组件获取不到开关值。

解决方法：
将FeatureFlags相关配置移至Values节点内，用冒号分隔层级：

{
  "IsEncrypted": false,
  "Values": {
    ...
    "FeatureFlags:xxxEnabled": true
  },
  "ConnectionStrings": {}
}

2. 配置节绑定错误 #

如果配置路径调整后，Startup中获取配置节的代码也需要对应修改，否则会读取到空的配置节，导致开关始终返回false。

解决方法：
调整Startup中的配置代码，从Values节点下读取FeatureFlags：

builder.Services.AddFeatureManagement(_configuration.GetSection("Values:FeatureFlags"));

或者遵循特性管理组件的默认约定，将配置改为FeatureManagement节点（组件会自动读取该节点）：

"Values": {
  ...
  "FeatureManagement:xxxEnabled": true
}

此时Startup代码可简化为：

builder.Services.AddFeatureManagement();

3. 同步调用异步方法的潜在问题 #

代码中使用.GetAwaiter().GetResult()同步阻塞调用异步方法，在Azure Function宿主环境中可能引发上下文死锁，间接导致配置读取异常（虽不一定是返回false的直接原因，但需规范写法）。

解决方法：
全程使用异步调用，移除同步阻塞代码：

if (await _manager.IsEnabledAsync("xxxEnabled"))
{
   await mymethod(order).ConfigureAwait(false);
}
else
{
  await mymethod2(order).ConfigureAwait(false);
}

4. 包版本与运行时兼容性问题 #

确保Microsoft.FeatureManagement.AspNetCore版本与你的Azure Function运行时（如.NET 6/8 Isolated模型）兼容，旧版本可能存在适配问题。

解决方法：
升级NuGet包至与当前Function runtime匹配的最新稳定版本，避免版本不兼容导致的异常。

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