Camunda BPM平台中表单版本号不递增问题分析与解决方案

问题背景

在Camunda BPM平台的使用过程中，开发人员发现当部署带有租户ID(TENANT_ID)的Camunda表单时，表单的版本号(VERSION_)不会随着表单内容的修改而递增。这个问题会导致系统始终认为表单版本为1，进而可能引发"无法解析唯一Camunda表单定义"的错误。

问题现象

具体表现为：

1. 部署带有租户ID的BPMN流程和关联的Camunda表单
2. 修改表单内容后重新部署
3. 检查数据库发现表单版本号仍为1，没有递增
4. 在某些情况下，系统会抛出"ENGINE-03109"错误，提示无法为表单键解析唯一定义

技术分析

通过深入分析Camunda BPM平台的源代码，发现问题根源在于SQL查询语句的参数映射错误。具体来说，在CamundaFormDefinition.xml文件中定义的selectLatestCamundaDefinitionByKeyAndTenantId查询语句中，子查询部分错误地使用了#{key}参数，而实际传入的参数名是camundaFormDefinitionKey。

这种参数名不匹配导致子查询无法正确执行，返回结果为null。因此，在部署新版本表单时，系统无法找到现有的最新表单定义，也就无法正确计算和设置新版本号，始终将版本号设置为1。

解决方案

修复方案非常简单但有效：将SQL查询中的参数名从#{key}更正为#{camundaFormDefinitionKey}，使其与实际传入的参数名一致。修改后的查询语句如下：

select *
from ${prefix}ACT_RE_CAMFORMDEF RES
where KEY_ = #{camundaFormDefinitionKey}
      and TENANT_ID_ = #{tenantId}
      and VERSION_ = (
          select max(VERSION_) 
          from ${prefix}ACT_RE_CAMFORMDEF 
          where KEY_ = #{camundaFormDefinitionKey} and TENANT_ID_ = #{tenantId})

影响范围

该问题影响所有使用租户ID部署Camunda表单的场景。对于不使用租户ID的表单部署，版本号递增功能工作正常。

修复版本

该修复已合并到Camunda BPM平台的主干代码中，并计划包含在以下版本中：

• 社区版7.22.0（预计2023年10月发布）
• 企业版维护版本7.19.15、7.20.8和7.21.4

技术启示

这个问题提醒我们：

1. 参数命名一致性在SQL映射文件中至关重要
2. 租户功能与非租户功能的代码路径可能存在差异，需要分别测试
3. 版本控制机制的正确性直接影响系统的稳定性和数据一致性

对于使用Camunda BPM平台并需要多租户支持的项目，建议关注此问题的修复进展，并在升级到包含修复的版本后验证表单版本控制功能是否正常工作。