Java Spring Boot应用Docker化运行时抛出UnsupportedClassVersionError异常排查

• 报错本质是Java运行时版本与应用编译版本不匹配：
  • 报错信息中提及的class file version 55.0是Java 11版本编译生成的字节码格式，当前容器内的运行时openjdk:8-jdk-alpine最高仅支持到class file version 52.0（对应Java 8的字节码格式），类加载阶段会直接抛出校验异常，无法启动应用。
  • 版本偏差来源：Dockerfile指定的容器内Java运行时为8版本，但你本地构建生成的target/*.jar是使用11版本JDK编译打出的，运行时版本低于编译时的JDK版本，直接触发启动失败。

你可以根据实际的版本要求二选一调整：

• 方案1：匹配基础镜像版本适配现有jar包
  如果你不需要强制使用Java 8运行，直接修改Dockerfile的第一行基础镜像，替换为和jar包编译版本匹配的Java 11基础镜像即可，修改后的Dockerfile如下：

  FROM openjdk:11-jdk-alpine
  RUN addgroup -S spring && adduser -S spring -G spring
  USER spring:spring
  ARG JAR_FILE=target/*.jar
  COPY ${JAR_FILE} app.jar
  ENTRYPOINT ["java","-jar","/app.jar"]
  

  调整完成后重新执行原有构建、运行命令即可，不需要改动本地应用的打包逻辑。
• 方案2：调整本地编译版本适配现有基础镜像
  如果你必须保留Java 8的运行时环境，就需要调整项目的构建配置：
  1. 检查Maven/Gradle的构建配置，将编译的源版本、目标版本设置为1.8
  2. 重新在本地执行清理打包命令，生成适配Java 8的jar包
  3. 重新构建Docker镜像并启动

常见踩坑提醒：部分场景下哪怕项目配置写的是Java 8编译版本，如果IDE或终端执行打包命令时默认调用的是Java 11及以上版本的JDK，依然会生成高版本字节码，打jar前可通过执行java -version确认当前执行打包的JDK版本，避免配置和实际执行不一致的问题。

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