📚 课程目录第3章规则引擎安装与环境配置

规则引擎安装与环境配置

说实话，搞规则引擎最怕的就是安装环境折腾半天。我当年第一次搭Drools的时候，光依赖冲突就追了两天。后来学乖了，总结了一套固定套路。今天我们就把这套玩意儿掰开揉碎，讲清楚。

环境依赖与版本选择

先看基础要求。规则引擎很多都是Java生态的，你像Drools、EasyRules、RuleBook，哪个也离不开JDK。我个人习惯直接用JDK 17 LTS，稳而且长期维护。

组件	最低版本	推荐版本	说明
JDK	8	17 LTS	建议用OpenJDK或GraalVM
Maven	3.6	3.9+	依赖管理和打包
规则引擎核心	7.x (Drools)	8.44.0.Final	最新稳定版
数据库（可选）	MySQL 5.7	MySQL 8.0	持久化规则状态

注意：我曾经在项目里用了Drools 6.x，结果和Spring Boot 2.7的自动配置冲突，差点耽误上线。版本一定要查兼容性矩阵。

安装步骤——走一遍就记住

别急着写代码，先把环境搭起来。我习惯分三布走：装JDK、配Maven、拉规则引擎依赖。

装JDK：下载OpenJDK 17，解压到 /opt/java，配好 JAVA_HOME 和 PATH。
配Maven：解压后改 settings.xml，加上阿里云镜像，不然下载jar包慢到哭。
建项目骨架：用Maven archetype或者直接建个Spring Boot项目，加drools-spring-boot-starter依赖。

来看看pom.xml里关键的部分：

<dependency>
    <groupId>org.drools</groupId>
    <artifactId>drools-spring-boot-starter</artifactId>
    <version>8.44.0.Final</version>
</dependency>
<dependency>
    <groupId>org.kie</groupId>
    <artifactId>kie-api</artifactId>
    <version>8.44.0.Final</version>
</dependency>

嗯，这里要注意：drools-spring-boot-starter 会帮你自动配置KieContainer，省事很多。

配置验证——拿个简单规则试试手

光依赖装好不行，得跑通才算数。我一般写个“Hello规则”来验证。在resources下建一个 rules/hello.drl 文件：

package com.example.rules

rule "sayHello"
    when
        $msg: String(this == "hello")
    then
        System.out.println("规则触发: 你好！");
end

然后写个启动类，注入 KieContainer，并插入一个“hello”字符串。运行后看控制台有没有打印。如果没打印，大概率是规则文件路径没扫到。

小技巧：把resources/rules目录放在类路径根下，默认KIE会扫描。如果你改过路径，记得在application.yml里配 spring.drools.path。

全貌图——安装配置流程

下面这张图把整个流程串起来了。从环境准备到验证运行，一步都不少。

常见问题与避坑

你猜怎么着？绝大部分新手都卡在这几个地方。我挨个说。

1. KieContainer 初始化失败：检查rules目录下是否有kmmodule.xml文件？没有的话手动创建一个空的。Drools 8不需要它，但7.x还有遗留检查。

2. 规则不执行：看看KieSession有没有用fireAllRules()？我见过有人写了个insert，忘记调用fire，规则静悄悄的。还有一个坑——规则文件中DRL语法写错，比如条件后面少了大括号，编译器不报错，但规则不会被加载。

3. 版本冲突：Spring Boot自带了一些依赖版本，比如slf4j、logback。你pom里如果显式指定了不同版本，可能会出现NoSuchMethodError。我的做法是：用 <dependencyManagement> 统一版本，不让子依赖乱拉版本。

避坑指南：我曾经因为同时引入了drools-core和drools-compiler的不同小版本，导致运行时KieBase创建异常。后来发现直接使用drools-spring-boot-starter，它会帮你处理好所有传递依赖。别手动加一堆，除非你清楚你在干啥。

4. 规则文件编码问题：如果.drl文件不是UTF-8编码，中文注释或者字符串字面量会乱码，甚至编译失败。我用IDE保存时一律选UTF-8，并且加上头部（虽然是注释，但习惯加上）。

多环境配置经验

研发环境跟生产环境，规则引擎配置往往不同。我的做法是把规则文件放外部，比如一个config文件夹，通过启动参数指定规则路径。比如在application.yml里：

drools:
  path: file:/opt/app/rules/
  mode: STREAM  # 流模式，适合事件流检测

生产上建议用STREAM模式，这样规则对时间窗口敏感。但测试环境用CLOUD模式就行，性能开销小。

还有一个点——数据库持久化。如果你的规则引擎需要保存规则状态（比如记录上次告警时间），就得配数据库。我用MySQL 8.0，加个kie-session的数据源配置。不过这个后面讲案例时会细说。

验证环境——快速测试脚本

最后，分享一个我常用的验证脚本。写个main方法，测一个简单规则：

// 伪代码：验证规则引擎环境
KieServices ks = KieServices.Factory.get();
KieContainer kContainer = ks.getKieClasspathContainer();
KieSession kSession = kContainer.newKieSession();

// 插入事实
Account account = new Account("prod_key", 1024);
kSession.insert(account);

// 执行规则
kSession.fireAllRules();

// 断言结果，看规则是否触发
assert account.getAlert() != null : "规则未触发，环境可能有问题";

把这个脚本跑通，你的环境就稳了。剩下的就是写业务规则，不是环境问题了。

说一千道一万，环境配置这关过去之后，后面就顺了。希望这份总结能帮你少走弯路。嗯，今天先到这儿。