java项目容器化需用java -jar /app.jar启动可执行jar,确保pom含spring-boot-maven-plugin且执行mvn clean package;选匹配编译版本的jre镜像(如jdk17编译则用openjdk:17-jre-slim);主进程退出问题优先前台运行查日志。

Java项目打包后怎么让Docker识别jar包入口
Java应用容器化最常卡在找不到主类或启动失败,根本原因是 Dockerfile 里没正确声明 JAR 的启动方式。JVM 运行时必须明确指定主类或可执行 jar 的路径,而 Spring Boot 打包出的 fat-jar 虽自带 MANIFEST.MF,但 Docker 不会自动读它。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 用
java -jar /app.jar启动,前提是app.jar是通过mvn spring-boot:repackage构建的可执行 jar(含Main-Class) - 显式指定主类更稳妥:
java -cp /app.jar com.example.Application,避免 MANIFEST 缺失或被覆盖 - 务必检查 jar 包是否真包含 class 文件:本地运行
jar -tf target/*.jar | head -n 5确认结构 - 别把
target/*.jar直接 COPY 到镜像根目录,容易权限/路径混乱;统一用/app/app.jar
Dockerfile里该选哪个JDK基础镜像
用错 JDK 镜像会导致运行时报 UnsupportedClassVersionError 或启动极慢,尤其新手常选 openjdk:latest 或 openjdk:17-jdk-slim 却没注意编译 JDK 版本。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 优先匹配编译环境:Maven 编译用 JDK 17,就选
openjdk:17-jre-slim(运行时不需要javac) - 别用
:latest—— 它可能突然升级到 JDK 21,导致 class 版本不兼容 - 生产环境禁用
-jdk镜像(体积大、含调试工具),-jre-slim或-jre-headless更合适 - Spring Boot 3.x 必须用 JDK 17+,若项目还是 Spring Boot 2.7.x,用
openjdk:11-jre-slim更稳
构建镜像时为什么总报“no main manifest attribute”
这个错误不是 Docker 的问题,而是 jar 包本身没被正确构建成可执行格式。典型场景是 Maven 没启用 spring-boot-maven-plugin,或者用了 mvn package 而非 mvn clean package 导致旧 jar 残留。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 确认
pom.xml中有spring-boot-maven-plugin插件配置,且未被<skip>true</skip>关闭 - 构建命令必须是
mvn clean package,不能只mvn package(否则可能复用上一次的空 jar) - 检查生成的 jar 是否真的含
META-INF/MANIFEST.MF:运行jar -xf target/*.jar META-INF/MANIFEST.MF && cat META-INF/MANIFEST.MF | grep Main-Class - 如果用的是普通 Java SE 项目(非 Spring Boot),就得自己写
MANIFEST.MF并用jar -cvmf打包,Docker 不会帮你补
容器启动后立刻退出怎么办
Docker 容器退出本质是主进程结束。Java 应用启动后立即退出,大概率是 JVM 进程没挂住 —— 常见于后台模式没开、日志输出阻塞、或 Spring Boot 启动失败但没抛异常到前台。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 加
-Dspring.main.web-application-type=none强制关闭 Web 容器,适合非 Web 项目,避免因端口占用失败却静默退出 - 启动命令末尾加
&& tail -f /dev/null只是掩耳盗铃,掩盖真正问题;先用docker run -it --rm your-image java -jar /app.jar直接前台运行看日志 - Spring Boot 默认开启
spring.application.admin.enabled=true时可能因网络初始化失败静默退出,临时关掉它 - 检查
application.properties里是否有server.port被设为已占用端口(如 8080),容器内无提示直接 fail-fast
最麻烦的其实是日志没刷出来就被 kill 掉 —— 记得在 Dockerfile 里加 ENV JAVA_OPTS="-XX:+PrintGCDetails -Dcom.sun.management.jmxremote=false",让 JVM 输出更早可见。










