将ActiveMQ-rar添加到Payara Micro 6 Docker镜像时遇类找不到错误

问题根源 #

Payara 6 基于 Jakarta EE 9.1，所有Java EE相关API已从javax.*命名空间迁移至jakarta.*；而你使用的ActiveMQ RAR 5.17.3仍依赖旧的javax.resource.spi包，JDK 17中已移除该旧命名空间的默认支持，因此部署时触发ClassNotFoundException。

Payara 5基于Java EE 8，与ActiveMQ 5.17.3的javax.*依赖兼容，且低版本JDK（如8/11）仍保留javax类路径，所以之前配置正常。

解决方案 #

1. 升级ActiveMQ RAR至兼容Jakarta EE的版本 #

ActiveMQ从5.18.0版本开始支持Jakarta EE 9（适配jakarta.*命名空间），替换当前的activemq-rar.rar为5.18.0及以上稳定版本即可解决问题。

操作步骤：

• 下载对应版本的RAR包（如activemq-rar-5.18.0.rar）
• 更新Dockerfile中复制RAR的路径，确保新文件被正确复制到/opt/payara/目录
• 重新构建镜像并验证部署

2. 临时兼容方案（不推荐长期使用） #

若暂时无法升级RAR，可通过添加参数尝试修复，但此方法仅作临时过渡：
在Payara启动命令中添加--add-modules java.se.ee，并将包含javax.resource API的依赖包加入--addlibs路径：

CMD exec \
java -jar -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=9009 -DTargetDatabase=${TARGET_DB} -jar /opt/payara/payara-micro.jar \
--disablephonehome \
--enablehealthcheck true \
--nocluster \
--postbootcommandfile /opt/cmd/postbootscript.txt \
--addlibs /opt/libs:/path/to/javax-resource-api.jar \
--add-modules java.se.ee \
--name ${HOSTNAME} \
--postdeploycommandfile /opt/cmd/postdeploy.asadmin \
--deploy /opt/payara/activemq-rar.rar

注意：该方案可能引发其他兼容性问题，优先推荐升级RAR版本。

验证要点 #

• 确认Dockerfile中RAR文件的复制路径与启动命令中的--deploy路径一致
• 预热命令（RUN阶段）和启动命令（CMD阶段）需使用同一版本的RAR包

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