c#如何使用RulesEngine_c#RulesEngine的4种方式-C#.Net教程-PHP中文网

RulesEngine 是轻量级.NET规则引擎，适合抽离简单业务规则（如“订单金额>1000打9折”），但不支持复杂状态机或高并发版本控制；需用JSON定义规则，注意属性大小写、RuleName必填及热更新异常处理。

c#如何使用rulesengine_c#rulesengine的4种方式

RulesEngine 是什么，它真适合你的业务规则场景吗

RulesEngine 是一个轻量级的 .NET 规则引擎库，核心价值在于把硬编码的 if-else 或 switch 拆出来，用 JSON/YAML 定义规则，运行时动态加载、执行、热更新。但它不是万能的：不支持复杂状态机、没有内置持久化、不处理高并发下的规则版本冲突。如果你只是想把“订单金额 > 1000 打 9 折”这类逻辑抽离，它很合适；如果要实现“用户连续 3 次失败登录后锁定 15 分钟”，就该换 WorkflowCore 或自研状态管理。

直接用 `RulesEngine` 类加载 JSON 规则并执行

这是最常用、也最容易上手的方式，适用于规则结构稳定、不频繁变更的内部服务。

确保安装 NuGet 包：RulesEngine（注意不是 RulesEngine.Core，后者是旧版或镜像）
规则 JSON 必须放在 rules.json 文件中，顶层是数组，每条规则含 RuleName、SuccessEvent、RuleExpressionType 和 Expression
Expression 是 C# 表达式字符串，会通过 Roslyn 编译，所以能访问传入对象的属性和方法，但不能用 await、using、本地函数等
执行前需构造 RulesEngine.RulesEngine 实例，并调用 ExecuteRule 方法，传入规则名和输入对象

var re = new RulesEngine.RulesEngine(ruleDefinitions, null);
var input = new { Amount = 1200, IsVip = true };
var result = re.ExecuteRule("ApplyDiscount", input);

常见错误：Expression 中写 amount > 1000（小写）但输入对象属性是 Amount（大写），抛出 Microsoft.CSharp.RuntimeBinder.RuntimeBinderException；或者 JSON 缺少 RuleName，导致 ExecuteRule 返回空结果。

用 `WorkflowRules` 实现多步骤规则链

当单条规则不够，你需要“先校验库存 → 再检查优惠券 → 最后计算运费”这样的顺序流程时，WorkflowRules 就派上用场了。

每个 workflow 是一个 JSON 对象，WorkflowName 唯一标识，Rules 是按执行顺序排列的规则名数组
所有子规则必须已注册到 RulesEngine 实例中（即在 ruleDefinitions 里定义过）
执行 workflow 用 ExecuteWorkflow，返回 IList，每个节点对应一步规则的结果
如果某步失败（IsSuccess == false），默认不会中断后续步骤；如需短路，得在规则的 Expression 里显式 throw 异常，或用 RuleAction 控制流

性能提示：workflow 不会自动缓存编译后的表达式，高频调用时建议复用同一个 RulesEngine 实例，避免重复解析 JSON 和 Roslyn 编译开销。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

集成 `IRuleService` 实现依赖注入与热重载

在 ASP.NET Core 项目中，硬编码 new RulesEngine 会导致生命周期混乱、配置难统一、规则无法热更新。

注册服务时用 AddRulesEngine 扩展方法（来自 RulesEngine.DependencyInjection 包），它会自动注入 IRuleService
IRuleService 提供 ReloadRulesAsync 方法，可监听文件变化或接收 HTTP 请求触发规则重载
注意：重载时旧规则实例仍在运行，新请求才走新规则；若需强一致性，得加锁或用版本号控制
避免在 Startup.ConfigureServices 中直接读取 IConfiguration 构建规则——此时配置可能未完全加载；应改用 IOptionsMonitor 或延迟初始化