运行Spring Boot Docker镜像时遭遇JNI错误及类版本不兼容问题

问题详情 #

执行命令docker run -p 8080:8080 nacer/my-image-name-1运行Docker镜像时，抛出如下错误：

Error: A JNI error has occurred, please check your installation and try again
Exception in thread "main" java.lang.UnsupportedClassVersionError: org/springframework/boot/loader/JarLauncher has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 52.0
at java.lang.ClassLoader.defineClass1(Native Method)
at java.lang.ClassLoader.defineClass(ClassLoader.java:756)
at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142)
at java.net.URLClassLoader.defineClass(URLClassLoader.java:473)
at java.net.URLClassLoader.access$100(URLClassLoader.java:74)
at java.net.URLClassLoader$1.run(URLClassLoader.java:369)
at java.net.URLClassLoader$1.run(URLClassLoader.java:363)
at java.security.AccessController.doPrivileged(Native Method)
at java.net.URLClassLoader.findClass(URLClassLoader.java:362)
at java.lang.ClassLoader.loadClass(ClassLoader.java:418)
at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:352)
at java.lang.ClassLoader.loadClass(ClassLoader.java:351)
at sun.launcher.LauncherHelper.checkAndLoadMain(LauncherHelper.java:601)

当前使用的Dockerfile内容：

FROM openjdk:8

EXPOSE 8080

ADD target/docker-demo-1.jar docker-demo-1.jar

ENTRYPOINT ["java","-jar","docker-demo-1.jar"]

本地Java版本为1.8.0_351，怀疑是Java版本不兼容导致无法运行Spring Boot应用。

问题原因 #

• 错误中的class file version 61.0对应Java 17，而Docker镜像使用的openjdk:8仅支持最高class file version 52.0（Java 8）。镜像内的Java运行环境版本低于编译docker-demo-1.jar时使用的Java版本，导致无法加载类。
• 本地Java版本不影响Docker容器内的运行环境，容器依赖的是镜像自带的Java环境。

解决方法 #

方法1：升级Docker镜像的Java版本 #

将Dockerfile的基础镜像替换为与jar包编译版本匹配的Java 17镜像，推荐使用维护更积极的eclipse-temurin镜像：

FROM eclipse-temurin:17-jre-alpine

EXPOSE 8080

ADD target/docker-demo-1.jar docker-demo-1.jar

ENTRYPOINT ["java","-jar","docker-demo-1.jar"]

重新构建并运行镜像：

docker build -t nacer/my-image-name-1 .
docker run -p 8080:8080 nacer/my-image-name-1

方法2：降级jar包的编译版本至Java 8 #

若需继续使用Java 8镜像，需调整项目编译配置：

• Maven项目：修改pom.xml中的编译版本配置：

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
</properties>

• 同时确认Spring Boot版本支持Java 8：Spring Boot 3.x最低要求Java 17，需降级至Spring Boot 2.x系列。

修改完成后重新打包jar，再构建Docker镜像运行即可。

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