Activiti流程手动部署失败：仅生成字节数组记录无流程定义

你的问题核心是手动部署时未给BPMN模型指定正确的资源后缀，导致Activiti无法识别并解析生成流程定义记录（re_procdef表无数据），仅存储了原始字节数据到ge_bytearray。

问题原因 #

Activiti在部署时会根据资源文件名的后缀（如.bpmn、.bpmn20.xml）来识别需要解析的BPMN资源。你代码中用processDefName = processDefFile.substring(0, processDefFile.indexOf(".bpmn20.xml"))去掉了后缀，导致添加到DeploymentBuilder的资源名称没有BPMN标识，Activiti跳过了流程定义解析步骤。

另外，你用resourceLoader.getResource(processFolderPath).getFile()读取目录的方式在Spring Boot jar包运行环境下会报错（jar内资源不是物理文件），这是潜在的环境兼容问题。

修复方案 #

1. 保留BPMN资源的正确后缀 #

添加BpmnModel时使用完整的文件名（包含.bpmn20.xml后缀），让Activiti识别为BPMN资源：

// 替换原来的processDefName赋值
// String processDefName = processDefFile.substring(0, processDefFile.indexOf(".bpmn20.xml"));
String processDefName = processDefFile; // 保留完整文件名
builder.addBpmnModel(processDefName, model);

2. 替换目录资源读取方式（兼容jar环境） #

改用ResourcePatternResolver批量读取classpath下的BPMN文件，避免File读取的限制：

import org.springframework.core.io.support.ResourcePatternResolver;

// 注入ResourcePatternResolver（Spring自动装配）
@Autowired
private ResourcePatternResolver resourcePatternResolver;

// 替换原有的目录读取逻辑
String processPattern = "classpath:/processes/*.bpmn20.xml";
Resource[] resources = resourcePatternResolver.getResources(processPattern);
DeploymentBuilder builder = repositoryService.createDeployment();
for (Resource resource : resources) {
    try (InputStream input = resource.getInputStream()) {
        InputStreamSource streamSource = new InputStreamSource(input);
        BpmnModel model = bpmnXMLConverter.convertToBpmnModel(streamSource, true, false);
        builder.addBpmnModel(resource.getFilename(), model);
    } catch (IOException e) {
        log.error(e.getMessage(), e);
    }
}
builder.deploy();

3. 验证转换后的BpmnModel有效性 #

可以在转换后添加日志，确认模型中包含流程定义：

if (model.getProcesses().isEmpty()) {
    log.warn("转换后的BPMN模型无流程定义，文件：{}", processDefFile);
} else {
    builder.addBpmnModel(processDefName, model);
}

验证 #

修复后重新运行代码，检查re_procdef表是否生成对应记录，同时可以通过以下代码查询已部署的流程定义：

List<ProcessDefinition> processDefinitions = repositoryService.createProcessDefinitionQuery().list();
log.info("已部署流程数量：{}", processDefinitions.size());

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