Camunda Platform 7.11.0环境下如何升级Java JDK至1.11.0版本

首先明确：Camunda 7.11.0 本身兼容 JDK 11，不存在核心版本冲突，容器场景下不要直接在运行容器内替换JDK（重启配置就会丢失），按以下流程操作即可

前置准备 #

• 先给当前运行的流程引擎做全量备份：导出所有自定义配置（bpm-platform.xml、数据源配置、引擎插件配置、日志配置），打一份数据库全量快照，避免升级出问题没法回滚。
• 排查所有自定义依赖：包括自行部署的流程插件、扩展包、对接的外部任务客户端，确认没有强依赖JDK8已移除的API（比如sun.misc包下的工具类、JDK内部自带的JAXB实现），有这类依赖先替换成JDK11兼容版本。
• 确认当前用的Camunda容器基础类型：是官方Tomcat/WildFly发行版镜像，还是从头构建的自定义镜像，两种场景改造逻辑有区别。

镜像改造 #

场景1：直接使用Camunda官方7.11.0镜像 #

官方7.11.0默认绑定JDK8，需要重新构建镜像，参考Dockerfile如下（以最常用的Tomcat发行版为例，WildFly版本逻辑一致，替换对应基础镜像即可）：

# 基础镜像选和原Camunda镜像匹配的Tomcat 9.0.x + JDK11版本，不要跨Tomcat大版本
FROM tomcat:9.0-jdk11-openjdk-slim
# 从官方7.11.0镜像中拷贝所有Camunda运行需要的依赖、web应用、默认配置
COPY --from=camunda/camunda-bpm-platform:7.11.0 /camunda /camunda
COPY --from=camunda/camunda-bpm-platform:7.11.0 /usr/local/tomcat/conf /usr/local/tomcat/conf
COPY --from=camunda/camunda-bpm-platform:7.11.0 /usr/local/tomcat/lib /usr/local/tomcat/lib
COPY --from=camunda/camunda-bpm-platform:7.11.0 /usr/local/tomcat/webapps /usr/local/tomcat/webapps
# 配置JVM参数适配JDK11，移除所有JDK8专属参数（比如MaxPermSize永久代配置，JDK11已经删除该参数，加了会启动失败）
ENV JAVA_OPTS="-Xms512m -Xmx2g -Djava.security.egd=file:/dev/./urandom --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.util=ALL-UNNAMED"
EXPOSE 8080
CMD ["catalina.sh", "run"]

注意：JDK11引入模块化机制，Camunda 7.11的部分反射逻辑需要加--add-opens放开模块访问权限，不然启动会报IllegalAccessError，别漏加。

场景2：使用自定义构建的Camunda镜像 #

直接修改Dockerfile里的基础镜像，把原来的JDK8镜像替换为同操作系统版本的JDK11镜像即可，比如原来用openjdk:8-jdk-slim就替换成openjdk:11-jdk-slim，同步清理JVM启动参数里JDK8专属的废弃参数，加上上面提到的模块开放参数。

验证与上线 #

• 先在测试环境用备份的生产数据快照启动新镜像，重点验证三类内容：
  • 引擎正常启动，Cockpit、Tasklist、Admin三个原生控制台可以正常访问登录
  • 全链路流程操作无异常：发起新流程、审批待办、触发异步任务、回调外部服务、查询历史数据都能正常跑通
  • 启动日志和运行日志没有ClassNotFound、NoSuchMethodError这类典型的版本兼容报错
• 生产环境升级建议停集群全量替换：先把所有节点的运行中作业、异步任务处理完，停掉旧版本容器，再启动新镜像节点，不要跨JDK版本做滚动升级，避免集群节点间序列化、版本号不一致的问题。

常见问题处理 #

• 启动报JAXB相关类找不到：JDK11默认把JAXB从核心类库移除了，直接在Tomcat的lib目录下补全JDK11兼容版本的jaxb-api、jaxb-impl、jaxb-core、activation四个包即可，不要拷贝JDK8自带的JAXB包。
• 报模块访问错误：根据报错提示的模块名，在JAVA_OPTS里补对应的--add-opens配置就行。
• 数据库连接失败：如果用的是比较老的JDBC驱动，替换成支持JDK11的驱动版本即可，Camunda7.11兼容的所有数据库版本都有对应的JDK11适配驱动。

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