JBPM casefile服务Maven依赖配置错误，API引用缺失如何解决

算力阿峰

2026-9-29

问题根因

你当前的配置存在两个核心错误：

普通依赖和BOM导入逻辑混淆：jbpm-services-api、jbpm-case-mgmt-api属于业务API依赖，需要直接引入jar包，你给它们加上<type>pom</type>和<scope>import</scope>后，Maven只会导入它们的依赖管理规则，不会下载对应的jar包，自然找不到相关类。
依赖冗余重复：同时导入了多个Kie/jbpm系列的BOM，还重复声明了同一个依赖的多个版本，容易引发版本冲突。

正确的pom.xml配置

第一步：配置统一依赖管理

仅保留必要的BOM导入即可，jbpm-bom已经统一管理了所有jbpm、kie相关组件的版本，不需要额外导入其他BOM：

<properties>
    <!-- 你已配置的版本属性 -->
    <version.org.kie>7.48.0.Final-redhat-00004</version.org.kie>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.jbpm</groupId>
            <artifactId>jbpm-bom</artifactId>
            <version>${version.org.kie}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

第二步：添加业务依赖

在dependencies节点添加你需要的API依赖，不需要额外声明版本、type和scope：

<dependencies>
    <!-- 包含CaseFileInstance、CaseService等案例管理相关接口 -->
    <dependency>
        <groupId>org.jbpm</groupId>
        <artifactId>jbpm-case-mgmt-api</artifactId>
    </dependency>
    <!-- 包含ServiceRegistry相关服务接口 -->
    <dependency>
        <groupId>org.jbpm</groupId>
        <artifactId>jbpm-services-api</artifactId>
    </dependency>
    <!-- 若需要案例管理运行时实现可添加该依赖，仅调用接口的话可以省略 -->
    <dependency>
        <groupId>org.jbpm</groupId>
        <artifactId>jbpm-case-mgmt-impl</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>