自定义类加载器加载类并创建Drools规则时出现编译错误

一、修复自定义ClassLoader导致的规则编译错误 #

1. 让Drools编译过程关联自定义ClassLoader #

你的DynamicClassLoader必须正确加载com.test.Test类，同时要把它设置为Drools编译时使用的类加载器，否则Drools找不到这个类，就会把类名误判成包名。示例代码：

// 初始化自定义类加载器，以当前线程类加载器为父类
DynamicClassLoader customClassLoader = new DynamicClassLoader(Thread.currentThread().getContextClassLoader());
// 这里写加载com.test.Test类到customClassLoader的逻辑
// ...

// 构建Kie相关组件时绑定自定义类加载器
KieServices kieServices = KieServices.Factory.get();
KieFileSystem kfs = kieServices.newKieFileSystem();
// 将规则文件写入KieFileSystem
kfs.write("src/main/resources/rules/testRule.drl", 
          kieServices.getResources().newInputStreamResource(new FileInputStream("你的规则文件路径")));

KieBuilder kieBuilder = kieServices.newKieBuilder(kfs).setClassLoader(customClassLoader);
kieBuilder.buildAll();

2. 修正规则文件的导入语句 #

错误提示“Only a type can be imported. com.test.Test resolves to a package”大多是因为规则导入写错，或者类没被正确加载导致Drools识别错误。确保规则文件开头的导入格式正确：

package com.test.rules;
import com.test.Test; // 必须是类的完整限定名，不能多写或少写

rule "Test Rule"
when
    $test: Test() // 类名大小写要和实际类完全一致
then
    // 规则执行逻辑
end

注意不要写成import com.test.Test.*;，除非你要导入该类的内部类。

二、修复KieContainer方式下KieBase无规则和类的问题 #

Drools 8.x对KieContainer的配置要求更明确，必须确保资源、类加载器和Kie模块配置正确关联：

1. 正确构建关联自定义ClassLoader的KieContainer #

DynamicClassLoader customClassLoader = new DynamicClassLoader(Thread.currentThread().getContextClassLoader());
// 加载com.test.Test类到customClassLoader的逻辑
// ...

KieServices kieServices = KieServices.Factory.get();
// 定义Kie模块模型，明确指定KieBase和KieSession的配置
KieModuleModel kieModuleModel = kieServices.newKieModuleModel();
KieBaseModel kieBaseModel = kieModuleModel.newKieBaseModel("testKieBase")
    .setDefault(true)
    .addPackage("com.test.rules"); // 必须和规则文件里的package一致

KieSessionModel kieSessionModel = kieBaseModel.newKieSessionModel("testKieSession")
    .setDefault(true)
    .setType(KieSessionModel.KieSessionType.STATELESS);

KieFileSystem kfs = kieServices.newKieFileSystem();
kfs.writeKModuleXML(kieModuleModel.toXML());
// 写入规则文件
kfs.write("src/main/resources/rules/testRule.drl", 
          kieServices.getResources().newInputStreamResource(new FileInputStream("你的规则文件路径")));

// 构建时绑定自定义类加载器
KieBuilder kieBuilder = kieServices.newKieBuilder(kfs).setClassLoader(customClassLoader);
kieBuilder.buildAll();

// 创建KieContainer时也要传入自定义类加载器
KieContainer kieContainer = kieServices.newKieContainer(
    kieServices.getRepository().getDefaultReleaseId(), 
    customClassLoader
);

// 验证KieBase内容
KieBase kieBase = kieContainer.getKieBase();
System.out.println("已加载规则数量：" + kieBase.getRules().size());
System.out.println("是否包含Test类：" + (kieBase.getFactType("com.test", "Test") != null));

2. 确保KieModule配置正确 #

必须通过KieModuleModel明确指定KieBase要包含的规则包，否则Drools不会自动扫描规则文件；同时规则文件的写入路径要符合Drools的资源约定，一般放在src/main/resources下对应包的路径下。

3. 验证类加载的可见性 #

通过customClassLoader.loadClass("com.test.Test")验证类是否能被正确加载，同时检查返回的类对象的类加载器是否是你的自定义ClassLoader，避免类加载隔离导致的问题。

三、常见排查点 #

• 检查规则文件语法：类名、包名的大小写是否和实际Java类完全一致，有没有拼写错误。
• 开启Drools Debug日志：查看规则编译过程中类加载的细节，能快速定位类找不到或规则未被扫描的原因。
• 避免类加载器泄漏：如果多次创建自定义ClassLoader，要确保旧的类加载器被正确回收，防止出现类重复加载的冲突。

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