ECR中Spring Boot镜像运行报Invalid or corrupt jarfile /app.jar错误咨询

你提供的Dockerfile本身不存在语法层面的错误，报错Error: Invalid or corrupt jarfile /app.jar的核心原因是镜像内的/app.jar不是合法的可执行JAR包，几乎都是构建阶段的文件传递、复制环节出错导致的，可按照以下步骤排查修复：

• 校验GitHub Actions中docker build阶段的参数传递：确认执行镜像构建命令时是否通过--build-arg JAR_FILE=实际jar路径传入了正确的Spring Boot构建产出路径。最常见的错误是路径拼写错误、层级不对、jar文件名写错，如果传入的路径指向非JAR文件，COPY指令会直接将错误文件重命名为app.jar，运行时自然会报损坏。
• 本地校验ECR镜像内的文件合法性：拉取对应镜像到本地后，依次执行以下命令验证：
  • 查看文件大小：docker run --rm --entrypoint ls <你的镜像地址> -l /app.jar，确认大小和本地构建的Spring Boot可执行jar大小一致
  • 验证文件类型：docker run --rm --entrypoint file <你的镜像地址> /app.jar，正常输出应该包含Java archive data (JAR)字样
    如果以上校验不通过，说明构建阶段复制的文件本身就是错误的。
• 排查Spring Boot构建环节：如果GitHub Actions工作流中同时包含Spring Boot构建和镜像构建步骤，需要确认maven/gradle构建步骤执行顺序在docker build之前，且构建产出的可执行jar路径和你传给JAR_FILE参数的路径完全匹配。如果是多模块项目，还要注意子模块的jar产出路径是否和参数配置一致，同时确认项目已经配置了Spring Boot打包插件，构建产出的是可执行jar而非普通jar包。
• 优化Dockerfile降低出错概率：可以去掉ARG动态参数配置，直接写死jar路径避免传参错误，比如如果jar固定产出在项目根目录的target文件夹下，可将COPY指令改为COPY target/*.jar /app.jar。也可以在COPY后新增校验逻辑，比如加一行RUN jar -tf /app.jar > /dev/null，如果jar文件不合法，镜像构建阶段就会直接报错，不需要等到运行时才发现问题。

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