Docker部署Camunda时SQL Server JDBC驱动加载失败求助

你遇到的ClassNotFoundException核心原因是JDBC驱动包没有被Camunda（基于Tomcat）的类加载器正确识别到，下面是针对性的解决步骤：

1. 修正驱动包的存放路径 #

Camunda基于Tomcat运行，Tomcat的类加载器只会自动加载其lib目录下的JAR包，你当前把驱动放在/tmp目录并通过CLASSPATH指定的方式无法被Tomcat识别。需要把驱动包复制到Camunda Tomcat的lib目录中：

修改Dockerfile中的驱动处理部分：

# 替换原有的驱动解压和CLASSPATH配置
COPY sqljdbc_7.4.1.0_enu.tar.gz /tmp/
WORKDIR /tmp
RUN tar -xf sqljdbc_7.4.1.0_enu.tar.gz && \
    # 复制对应JRE11版本的驱动到Camunda Tomcat的lib目录
    cp /tmp/sqljdbc_7.4/enu/mssql-jdbc-7.4.1.jre11.jar /camunda/server/apache-tomcat/lib/

2. 确保驱动包与Java版本匹配 #

你的镜像使用OpenJDK11，必须对应使用jre11版本的驱动包。Camunda 7.12要求OpenJDK11，而SQL Server JDBC驱动7.4的jre11包是专门适配这个版本的，之前尝试jre8/jre12会存在兼容性问题。

3. 修复驱动包的权限问题 #

由于你切换到了camunda用户运行应用，需要确保驱动包的权限允许该用户读取：

RUN tar -xf sqljdbc_7.4.1.0_enu.tar.gz && \
    cp --chown=camunda:camunda /tmp/sqljdbc_7.4/enu/mssql-jdbc-7.4.1.jre11.jar /camunda/server/apache-tomcat/lib/

4. 移除无效的CLASSPATH配置 #

Docker中RUN export CLASSPATH=...只会在当前构建层生效，不会传递到容器运行时；即使使用ENV设置CLASSPATH，Tomcat的类加载机制也优先使用自身lib目录的JAR，所以这些配置可以完全移除，避免混淆。

完成以上修改后重新构建镜像，Camunda的数据源配置就能正确加载SQL Server JDBC驱动了。

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