Activiti 手动部署 BPMN 流程失败：无可用流程定义的解决方案-java教程-PHP中文网

Activiti 手动部署 BPMN 流程失败：无可用流程定义的解决方案

Activiti 手动部署 BPMN 文件时，仅生成 ge_bytearray 记录而未创建 re_procdef 中的流程定义，通常因重复部署名称导致部署被跳过；需确保每次部署使用唯一名称或清空历史部署。

activiti 手动部署 bpmn 流程时，仅生成 ge_bytearray 记录而未创建 re_procdef 中的流程定义，通常因重复部署名称导致部署被跳过；需确保每次部署使用唯一名称或清空历史部署。

在 Spring Boot + Activiti 环境中，从自动部署（如 spring.activiti.check-process-definitions=true）切换为手动 Java 部署时，一个常见却隐蔽的问题是：部署名称（deployment name）重复。Activiti 默认会对同名部署进行幂等处理——若已存在同名部署，它将跳过实际解析与流程定义注册，仅将 BPMN XML 写入 ge_bytearray 表（表现为 BYTES_ 字段中的 BLOB），而不会生成对应的 re_procdef 记录，导致后续无法启动流程实例。

你的代码逻辑本身基本正确（加载 BPMN、转换为 BpmnModel、调用 addBpmnModel()），但缺失了关键一步：显式设置唯一部署名称。Activiti 的 DeploymentBuilder 若未指定名称，会使用默认空字符串或内部生成的非唯一标识，极易触发重复部署判定。

✅ 正确做法是：每次部署必须使用唯一名称。推荐方式如下：

// ✅ 推荐：使用时间戳 + 随机后缀，确保全局唯一
String deploymentName = "process-deployment-" + System.currentTimeMillis() + "-" + UUID.randomUUID().toString().substring(0, 8);
DeploymentBuilder builder = repositoryService.createDeployment()
    .name(deploymentName); // ← 关键：必须显式设置唯一 name！

// 后续保持原有逻辑（加载文件、转换模型、addBpmnModel...）
if (processDirectory.exists()) {
    Arrays.stream(Objects.requireNonNull(processDirectory.list()))
        .sequential()
        .forEach(processDefFile -> {
            try {
                String resource = processFolderPath + processDefFile;
                InputStream input = resourceLoader.getResource(resource).getInputStream();
                InputStreamSource streamSource = new InputStreamSource(input);
                BpmnModel model = bpmnXMLConverter.convertToBpmnModel(streamSource, true, false);
                String processDefName = processDefFile.substring(0, processDefFile.indexOf(".bpmn20.xml"));
                builder.addBpmnModel(processDefName, model);
            } catch (IOException e) {
                log.error("Failed to load or parse BPMN file: {}", processDefFile, e);
            }
        });
} else {
    log.warn("Process directory not found: {}", processFolderPath);
}

builder.deploy(); // 现在 deploy() 将真正注册流程定义

⚠️ 注意事项：

不要依赖 spring.activiti.deployment-name 配置项：该配置仅作用于自动部署阶段（SpringProcessEngineConfiguration 初始化时），对运行时手动 createDeployment() 无效；
避免手动清理数据库（如删除 act_re_deployment 表记录）：虽可临时解决，但破坏数据一致性且不可靠；应通过代码保证部署唯一性；

验证部署结果：部署后建议添加断言或日志验证：

Deployment deployment = builder.deploy();
long procDefCount = repositoryService.createProcessDefinitionQuery()
    .deploymentId(deployment.getId())
    .count();
log.info("Deployed {} process definitions under deployment ID: {}", procDefCount, deployment.getId());