Camunda WAR部署时同一BPMN文件重复部署的问题咨询

原因分析 #

出现同一个BPMN被两次部署的核心原因是Camunda的两种自动部署机制同时生效：

1. 流程应用（ProcessApplication）自动部署：当项目包含继承ServletProcessApplication的ProcessApplication类时，Camunda会自动扫描该应用下的流程定义并部署，归档名默认是项目名称。
2. 引擎级扫描部署：processes.xml中isScanForProcessDefinitions="true"会触发Camunda引擎扫描classpath下的流程定义并部署，归档名默认是processApplication。

两种机制并行运行，就导致了同一流程定义被重复部署。

具体解决步骤 #

方案1：关闭processes.xml中的自动扫描（推荐） #

如果你的项目通过ProcessApplication管理流程部署，建议禁用引擎级的自动扫描，只保留ProcessApplication的部署逻辑：

• 打开META-INF/processes.xml，将isScanForProcessDefinitions的值改为false：

<process-application
  xmlns="http://www.camunda.org/schema/1.0/ProcessApplication"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://www.camunda.org/schema/1.0/ProcessApplication http://www.camunda.org/schema/1.0/ProcessApplication">

  <process-archive name="your-project-name">
    <properties>
      <property name="isScanForProcessDefinitions">false</property>
      <!-- 保留其他必要配置，比如部署模式、资源路径等 -->
    </properties>
  </process-archive>
</process-application>

方案2：禁用ProcessApplication的自动部署（特殊场景使用） #

如果需要通过processes.xml统一管理流程部署，可关闭ProcessApplication的自动部署：

• 在你的ProcessApplication类上添加@DisableProcessDeployment注解：

import org.camunda.bpm.application.ProcessApplication;
import org.camunda.bpm.application.impl.ServletProcessApplication;
import org.camunda.bpm.application.annotation.DisableProcessDeployment;

@ProcessApplication("your-project-name")
@DisableProcessDeployment
public class YourProcessApplication extends ServletProcessApplication {
  // 类内容保持不变
}

同时确保processes.xml中isScanForProcessDefinitions="true"，由引擎统一扫描部署。

方案3：统一归档名（配合前两种方案使用） #

为了让部署记录更清晰，可将两种部署方式的归档名统一：

• 在processes.xml中指定归档名：

<process-archive name="your-project-name">
  <properties>
    <property name="isScanForProcessDefinitions">true</property>
  </properties>
</process-archive>

• 在ProcessApplication注解中指定相同名称：

@ProcessApplication("your-project-name")
public class YourProcessApplication extends ServletProcessApplication {
  // 类内容
}

注意：此方案仅统一名称，无法解决重复部署问题，必须配合方案1或2使用。

验证方法 #

部署修改后的WAR包后，检查Cockpit控制台的流程定义列表，确认同一BPMN仅出现一次；同时查看服务器日志，确保只有一条该流程的部署记录。

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