kmodule.xml 中 kbase 和 ksession 必须显式声明，因 Drools 6+ 不自动扫描规则，且仅通过该文件加载配置；漏写会导致 KieContainer 无法获取会话而抛 IllegalStateException。
为什么 kmodule.xml 里 kbase 和 ksession 必须显式声明
因为 Drools 6+ 默认不自动扫描规则，kmodule.xml 是唯一被加载的配置入口。漏写 kbase 或没配 ksession，KieContainer 就拿不到可用会话，运行时抛 java.lang.IllegalStateException: No KieSession found。
实操建议：
-
kbase必须指定packages（如packages="rules"），路径要和 src/main/resources 下实际目录一致；大小写敏感，错一个字母就找不到规则文件 -
ksession的type建议明确写成stateful或stateless，别依赖默认值——Drools 7.50+ 后默认行为已变，不写可能初始化失败 - 一个
kmodule.xml可以有多个kbase，但每个必须有唯一name；同名会导致后加载的覆盖前一个，调试时规则“消失”往往就是这个原因
classpath 路径对不上？检查 resources 目录结构和 packages 值
Drools 不解析 Java 包路径，只按 packages 值在 classpath 根下找目录。比如 packages="com.example.rules"，它会在 src/main/resources/com/example/rules/ 下找 .drl 文件，而不是去 src/main/java/ 里翻。
常见错误现象：
- 规则文件明明存在，却提示
Unable to resolve ObjectType 'MyFact'—— 实际是.drl根本没被加载，因为packages写成了"rules"，但文件放在了resources/com/example/rules/ - Maven 构建后
target/classes里没有规则文件 —— 检查pom.xml是否遗漏.drl（Drools 默认只加载.drl、.drt、.xls）
用 Spring Boot 整合 Drools 时，kmodule.xml 放哪、要不要删
Spring Boot + Drools 场景下，kmodule.xml 仍需保留，但位置和内容可简化：必须放在 src/main/resources/META-INF/kmodule.xml，且只需最简结构 —— 多余的 includes、configuration 反而容易触发类加载冲突。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
实操建议：
- 删掉所有
KieServices自动注册 bean，不需要手动 include 其他 kbase - 避免在
kmodule.xml里配watch或scanner，这些功能在 Spring 环境下由@KieScanner注解接管，重复配置会导致启动报Multiple KieScanner beans - 如果用了
kie-server，本地kmodule.xml里的ksession名称必须和 server 上部署的容器 ID 一致，否则远程调用返回 404
规则热更新失效？确认 kmodule.xml 没硬编码版本号
Drools 的 KieScanner 依赖 kmodule.xml 中的 version 属性判断是否更新。如果写死 version="1.0"，改了规则文件但没改 version，scanner 就认为“没变”，跳过重新编译。
关键细节：
-
version属性（那是 XSD 版本，不是业务版本） - 真正起作用的是
version属性，例如 - CI/CD 流水线中，建议用 Maven 插件自动生成 version（如
${project.version}），人工维护极易漏同步
热更新不是万能的——修改了规则中的函数定义、新增了全局变量，或改动了 declare 的 fact 类型字段，依然需要重启应用。kmodule.xml 只管 .drl 文本变更。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
