当前位置: 首页 > news >正文

.NET 应用如何优雅的做功能开关(Feature Flag)

目录

.NET 功能管理库

安装功能管理库

添加功能开关配置项

使用功能开关

在 Controller 级别添加功能开关

在 Action 级别添加功能开关

在 View 上添加功能开关

根据功能开关添加 Filter

根据功能开关添加 Middleware

小提示


导语

曾经,我们要在应用程序里做功能开关,就避免不了在配置文件里加上一堆 bool 类型的配置项,然后在代码里用 if else 去判断。尽管这种做法是可行的,但我们现在有办法让代码更加整洁,避免成堆的 if else 出现。

.NET 功能管理库

微软为了解决常见的功能开关问题场景,推出了 .NET Core Feature Management 库。它由 Azure 团队发布,并属于 Azure 文档的一部分,但我发现就算在没有 Azure 环境的情况下,它依然可以正常全功能运行

Azure 在此的作用仅仅是用 Azure App Configuration 作为功能开关的数据源,而我们完全可以用本地的 appsettings.json 来替代,避免了购买 Azure 从而落魄街头的风险

安装功能管理库

以我的博客系统为例,我的应用是 ASP.NET MVC / Web API类型的,我需要添加的包为Microsoft.FeatureManagement.AspNetCore。如果你的应用并非ASP.NET,可以只添加Microsoft.FeatureManagement

<PackageReference Include="Microsoft.FeatureManagement" Version="2.2.0" />

然后注册到 DI 里去

using Microsoft.FeatureManagement; public class Startup { public void ConfigureServices(IServiceCollection services) { services.AddFeatureManagement(); } }

添加功能开关配置项

以我的博客系统为例,原先我在 AppSettings section 中有两个bool类型的配置项,现在就可以迁移到名为FeatureManagement的新 section 里。

相对应的,在 C# 代码里,去掉原来的项,添加一个新的枚举类型,值的名称对应配置项的名称。

这个枚举类型不是必须的,但非常建议创建枚举,这是为了保证在使用功能开关的时候有强类型支持,避免用string导致哪里名字没改对造成996。

使用功能开关

我们只需从DI里拿到 IFeatureManager 的实例,即可判断功能开关是否打开。例如:

IFeatureManager featureManager; ... if (await featureManager.IsEnabledAsync(nameof(MyFeatureFlags.FeatureA))) { // 执行代码 }

在 ASP.NET 项目里,最方便的就是通过构造函数获取 IFeatureManager 的实例

public class HomeController : Controller { private readonly IFeatureManager _featureManager; public HomeController(IFeatureManager featureManager) { _featureManager = featureManager; } }

那么问题来了,说好的少写 if else 呢?这个 IsEnabledAsync 不还是得写 if?

其实 Microsoft.FeatureManagement.AspNetCore 这个包包括了 MVC / Web API 项目所需要用到的许多助手功能。可以让我们避免大量的 if else。

在 Controller 级别添加功能开关

还是以我博客系统为例,我的 GraphController 只有在 EnableWebApi 开关打开的时候才响应用户请求,那么本来的 if else 判断现在就可以:

[FeatureGate(FeatureFlags.EnableWebApi)] // ... public class GraphController : ControllerBase { // ... }

是不是很爽?

在 Action 级别添加功能开关

[FeatureGate(FeatureFlags.EnableAudit)] public async Task<IActionResult> ClearAuditLogs() { // ... }

在 View 上添加功能开关

先在 _ViewImports.cshtml 中添加 taghelper 声明。

@addTagHelper *, Microsoft.FeatureManagement.AspNetCore

然后就可以用 <feature> 标签选择性的渲染 HTML 内容了!

<feature name="FeatureA"> <p>This can only be seen if 'FeatureA' is enabled.</p> </feature>

对于feature关闭才显示的内容,加个 negate 就好了

<feature name="FeatureA" negate="true"> <p>This will be shown if 'FeatureA' is disabled.</p> </feature>

还可用 All, Any 属性控制多个功能开关的显示处理。All 表示列出的功能得全启用才执行,Any 表示列出的功能里任意一个为 true 就可以执行。

<feature name="FeatureA, FeatureB" requirement="All"> <p>This can only be seen if 'FeatureA' and 'FeatureB' are enabled.</p> </feature> <feature name="FeatureA, FeatureB" requirement="Any"> <p>This can be seen if 'FeatureA', 'FeatureB', or both are enabled.</p> </feature>

根据功能开关添加 Filter

使用 AddForFeature() 拓展方法

using Microsoft.FeatureManagement.FeatureFilters; IConfiguration Configuration { get; set;} public void ConfigureServices(IServiceCollection services) { services.AddMvc(options => { options.Filters.AddForFeature<SomeMvcFilter>(nameof(MyFeatureFlags.FeatureA)); }); }

根据功能开关添加 Middleware

app.UseMiddlewareForFeature<ThirdPartyMiddleware>(nameof(MyFeatureFlags.FeatureA));

或者

app.UseForFeature(featureName, appBuilder => { appBuilder.UseMiddleware<T>(); });

小提示

功能开关的配置值更改,无需重启应用程序,修改配置文件后可以热更新,立即生效!

另外,如果你足够有钱,也推荐试试 Azure App Configuration,将你的应用功能开关放在云端统一管理,可以非常方便的针对用户群体配置 A/B,蓝绿测试哦!

参考文档:https://docs.microsoft.com/en-us/azure/azure-app-configuration/use-feature-flags-dotnet-core?WT.mc_id=AZ-MVP-5002809

引入地址

http://www.jsqmd.com/news/264902/

相关文章:

  • bert-base-chinese命名实体识别实战:免配置10分钟上手
  • Qwen3-VL-2B性能测试:CPU环境下的视觉理解能力评估
  • ComfyUI模型微调:基于特定领域数据的LoRA训练
  • 科哥OCR镜像导出ONNX后推理速度表现如何?实测告诉你
  • JavaScript调用IndexTTS-2-LLM:网页语音播报实战教程
  • CosyVoice流式合成教程:云端GPU 3步搞定,成本不到5元
  • 5分钟搭建个人AI画室,麦橘超然Flux太适合新手
  • 用GLM-ASR-Nano-2512做的语音转文字工具,效果超预期
  • 从需求到上线:MinerU智能文档系统项目实施完整路线图
  • 开发者入门必看:FSMN VAD镜像快速部署实操
  • GPEN直播美颜预研案例:实时增强可行性测试部署教程
  • 本地运行Qwen3-Embedding-0.6B,CPU环境也能跑
  • 小白必看!Qwen3-VL多模态AI保姆级教程:从图片上传到智能问答
  • 从0开始学大模型微调:Qwen镜像使用全记录
  • 真实案例分享:YOLOE镜像在智能监控中的应用
  • GLM-4.6V-Flash-WEB工业检测:缺陷识别自动化探索
  • Z-Image-Turbo为何报错CUDA?GPU驱动兼容性解决步骤
  • 基于HY-MT1.5-7B镜像的上下文感知翻译实现方法详解
  • 幼儿园节日活动策划:AI出图系统快速搭建案例
  • 10分钟掌握语音情感分析:SenseVoiceSmall快速入门
  • 从0开始学AI分割:SAM 3让视频处理更简单
  • Hunyuan-MT-7B工具链测评:Jupyter与WEBUI协同使用教程
  • 通义千问3-4B教育场景应用:个性化辅导系统搭建
  • NewBie-image-Exp0.1与Miku风格生成对比:多角色控制能力全面评测
  • 5分钟部署Qwen3-Embedding-4B,零基础搭建多语言向量服务
  • Qwen All-in-One故障演练:混沌工程实战配置
  • Live Avatar实战指南:多GPU配置下数字人生成性能对比
  • Qwen3-4B-Instruct部署扩展性设计:未来升级路径规划
  • BGE-M3性能测试:不同硬件配置下的表现
  • 可视化识别结果:matplotlib绘图代码示例