Camunda 7.17迁移至7.20级联删部署时遇Schema错误求助

核心原因 #

虽然官方文档标注该版本跨度无需手动Schema迁移，但Camunda在7.18及后续版本中对ACT_RU_TASK表新增了LAST_UPDATED_列，若启动时自动Schema更新未生效（如配置限制、权限不足），就会导致查询异常。

具体解决步骤 #

• 检查Schema更新配置
  确认Camunda的Schema更新策略配置是否允许自动更新：

  • Spring Boot环境：检查application.yml/application.properties中的camunda.bpm.database.schema-update，设置为update或true（若被手动改为none会阻止更新）。
  • 传统部署：检查processes.xml中的schema-update属性，确保值不为false。

• 手动添加缺失列
  若自动更新无法触发，直接在数据库中执行对应SQL添加列（根据数据库类型调整）：

  -- MySQL/MariaDB
  ALTER TABLE ACT_RU_TASK ADD COLUMN LAST_UPDATED_ DATETIME(3) NULL;
  
  -- PostgreSQL
  ALTER TABLE ACT_RU_TASK ADD COLUMN LAST_UPDATED_ TIMESTAMP(3);
  
  -- Oracle
  ALTER TABLE ACT_RU_TASK ADD LAST_UPDATED_ TIMESTAMP(3);
  

  注意：列类型需与同库中其他LAST_UPDATED_列（如ACT_RU_EXECUTION.LAST_UPDATED_）保持一致。

• 分步升级确保Schema同步
  跨版本直接升级可能导致自动更新遗漏中间步骤，可按以下顺序操作：

  1. 回退到Camunda 7.18版本启动服务，等待自动Schema更新完成。
  2. 升级到7.19版本启动，确认无异常。
  3. 最后升级到7.20版本。

• 验证数据库权限
  确保Camunda使用的数据库账号拥有ALTER TABLE权限，否则自动Schema更新会静默失败，可查看Camunda启动日志排查权限相关报错。

注意事项 #

操作数据库前务必备份数据，添加列后重启Camunda服务，再测试级联删除部署的操作是否正常。

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