Flowable 7.0.0无法自动部署BPMN文件问题求助

1. 检查构建工具的资源复制配置 #

Spring Boot默认会把src/main/resources下的文件同步到target/classes，但自定义的资源过滤规则可能导致processes目录被忽略：

Maven项目 #

打开pom.xml，确认<build>下的<resources>配置没有排除processes目录，或者直接添加明确的包含规则：

<resources>
    <resource>
        <directory>src/main/resources</directory>
        <includes>
            <include>**/*</include>
            <include>processes/**/*.bpmn20.xml</include>
        </includes>
        <filtering>false</filtering> <!-- 避免BPMN文件被错误过滤 -->
    </resource>
</resources>

Gradle项目 #

修改build.gradle的sourceSets配置，确保包含processes下的BPMN文件：

sourceSets {
    main {
        resources {
            srcDirs = ['src/main/resources']
            includes = ['**/*', 'processes/**/*.bpmn20.xml']
        }
    }
}

2. 验证文件是否被正确复制到构建目录 #

执行mvn clean package（Maven）或gradle clean build（Gradle）后，直接查看target/classes目录：

• 如果processes文件夹不存在，说明资源复制逻辑有问题，回到第一步排查配置。
• 如果文件夹存在但文件缺失，检查文件名拼写（比如后缀是否是.bpmn20.xml或.bpmn，Flowable默认识别这两种）。

3. 修正手动部署的资源加载方式 #

如果资源确实在target/classes/processes下，但addClasspathResource找不到，换用类加载器先验证资源存在性，再用流的方式部署：

@Autowired
private ProcessEngine processEngine;

// 先验证资源是否存在
ClassLoader classLoader = getClass().getClassLoader();
URL resourceUrl = classLoader.getResource("processes/" + xmlName + ".bpmn20.xml");
if (resourceUrl == null) {
    throw new RuntimeException("BPMN资源不存在");
}

// 用输入流部署
RepositoryService repositoryService = processEngine.getRepositoryService();
Deployment deployment = repositoryService.createDeployment()
    .addInputStream(xmlName + ".bpmn20.xml", resourceUrl.openStream())
    .deploy();

4. 显式配置Flowable自动部署路径 #

Flowable 7.0.0结合Spring Boot 3.x，自动部署的默认扫描路径可能有变化，在配置文件里明确指定：

application.yml #

flowable:
  process:
    deployment:
      resources: classpath*:processes/**/*.bpmn20.xml
      auto-deploy: true

application.properties #

flowable.process.deployment.resources=classpath*:processes/**/*.bpmn20.xml
flowable.process.deployment.auto-deploy=true

5. 处理Java 17模块化项目的资源访问 #

如果项目使用了module-info.java，需要让Flowable能访问processes目录下的资源：

module your.module.name {
    requires org.flowable.spring.boot.starter;
    opens processes to org.flowable.engine;
}

6. 清理构建缓存 #

有时候缓存会导致旧的文件结构残留，执行以下命令彻底清理后重新构建：

• Maven：mvn clean install
• Gradle：gradle clean build

内容的提问来源于stack exchange，提问作者Valentina Carrington