Docker环境运行Fat Jar时KieRepository实例抛出空指针异常问题

你触发空指针的代码行是kservice.getRepository()，说明KieServices.Factory.get()返回了null，即Drools的核心服务类初始化失败。本地和普通服务器运行正常、仅Docker环境报错，基本是类加载依赖缺失、SPI配置丢失、容器环境权限三类问题导致。

• 第一步：确认Docker镜像JRE环境依赖完整性 #

Drools 7.x版本依赖JAXB模块，Java 11及以上版本默认不内置JAXB，如果你使用的是精简版JRE镜像（比如Alpine OpenJDK 11+精简版），会因为缺少JAXB依赖导致KieServices初始化失败。
解决方案：
在build.gradle中补全JAXB相关依赖：

implementation 'javax.xml.bind:jaxb-api:2.3.1'
implementation 'com.sun.xml.bind:jaxb-impl:2.3.1'
implementation 'com.sun.xml.bind:jaxb-core:2.3.1'
implementation 'javax.activation:activation:1.1.1'

也可以直接换用完整版JDK作为基础镜像，避免依赖缺失。

• 第二步：检查SPI配置合并配置 #

Spring Boot打Fat Jar时如果没有配置SPI文件合并，多个依赖中同名的META-INF/services/org.kie.api.KieServices配置会被覆盖，导致SPI加载不到实现类。普通服务器如果是解压后按目录运行、或者IDE开发时按类路径顺序加载就不会触发该问题。
解决方案：
在build.gradle中配置BootJar合并SPI配置文件：

bootJar {
    mergeServiceFiles()
}

如果使用原生jar任务打包，替换为jar任务配置即可。

• 第三步：排查容器临时目录权限 #

Drools初始化时会向系统临时目录（默认/tmp）写入编译产生的临时文件，如果Docker容器的运行用户没有/tmp目录的读写权限，也会导致KieServices初始化失败。
解决方案：
在Dockerfile中给临时目录赋权：

RUN chmod 777 /tmp

也可以在启动命令中指定Drools使用有读写权限的临时目录：

java -Dkie.repository.tmpdir=/opt/app/tmp -jar your-app.jar

你可以先在本地直接执行java -jar运行打的Fat Jar，如果本地运行也报错，就是SPI配置的问题；如果本地运行正常，Docker中报错，优先排查JRE依赖和权限问题。排查时可以加启动参数-Dorg.slf4j.simpleLogger.defaultLogLevel=debug输出Drools初始化的详细日志，定位具体失败原因。

内容的提问来源于stack exchange，提问作者Sarthak Srivastava