news 2026/4/30 17:11:40

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
.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

引入地址

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/4/30 20:50:20

Microsoft Agent Framework 与 Semantic Kernel 全维度深度拆解与实战指南

目录 摘要&#xff08;给时间不多但又不想 FOMO 的你&#xff09; 一、背景&#xff1a;为什么在已有 Semantic Kernel 后还需要 Agent Framework&#xff1f; 二、定位与抽象层级&#xff1a;概念金字塔对齐 三、源码与项目结构解读&#xff08;聚焦 MAF&#xff09; 四、…

作者头像 李华
网站建设 2026/5/1 4:06:45

没技术背景玩转AI翻译:HY-MT1.5云端可视化

没技术背景玩转AI翻译&#xff1a;HY-MT1.5云端可视化 你是不是也遇到过这样的情况&#xff1f;手头有一堆外文书稿要处理&#xff0c;语言五花八门&#xff0c;编辑团队又没人精通这些语种。请专业翻译公司吧&#xff0c;成本高、周期长&#xff1b;自己上机器翻译工具&#…

作者头像 李华
网站建设 2026/5/1 5:07:10

科哥OCR镜像导出ONNX后推理速度表现如何?实测告诉你

科哥OCR镜像导出ONNX后推理速度表现如何&#xff1f;实测告诉你 1. 背景与问题提出 在当前AI应用快速落地的背景下&#xff0c;OCR&#xff08;光学字符识别&#xff09;技术广泛应用于文档数字化、证件识别、票据处理等场景。模型部署效率成为影响系统响应速度和用户体验的关…

作者头像 李华
网站建设 2026/5/1 5:05:17

从0开始学大模型微调:Qwen镜像使用全记录

从0开始学大模型微调&#xff1a;Qwen镜像使用全记录 1. 引言&#xff1a;为什么需要快速上手的大模型微调方案&#xff1f; 在当前大模型技术快速发展的背景下&#xff0c;如何高效、低成本地完成模型定制化成为开发者关注的核心问题。传统全参数微调&#xff08;Full Fine-…

作者头像 李华
网站建设 2026/5/1 5:01:40

Z-Image-Turbo生成质量不稳定?参数调优实战教程分享

Z-Image-Turbo生成质量不稳定&#xff1f;参数调优实战教程分享 Z-Image-Turbo是阿里巴巴通义实验室开源的高效AI图像生成模型&#xff0c;作为Z-Image的蒸馏版本&#xff0c;它在保持高质量图像输出的同时大幅提升了推理速度。该模型仅需8步即可完成图像生成&#xff0c;具备…

作者头像 李华
网站建设 2026/5/1 5:03:34

VibeThinker-1.5B实战教程:构建你的私人编程助手

VibeThinker-1.5B实战教程&#xff1a;构建你的私人编程助手 1. 简介与技术背景 VibeThinker-1.5B 是一个参数量为15亿的密集型语言模型&#xff0c;专为高效推理任务设计。尽管其规模较小&#xff0c;但凭借精心优化的训练策略和数据选择&#xff0c;在数学推理与代码生成任…

作者头像 李华