Spring Boot打包Docker镜像全流程教程

Spring Boot项目打包成Docker镜像的步骤如下：1. 确保项目能正常构建，使用mvn package或gradle build生成jar包，并在pom.xml中指定主类以避免启动问题；2. 创建Dockerfile定义镜像构建逻辑，包括选择合适的基础镜像、设置工作目录、复制jar包并配置启动命令；3. 构建并运行Docker镜像，使用docker build和docker run命令完成，并通过docker logs和docker exec进行调试；4. 可选使用多阶段构建优化镜像体积，提升安全性和减少资源占用。按照这些步骤操作，大多数Spring Boot项目都能顺利打包为Docker镜像。

Spring Boot项目打包成Docker镜像，其实并不复杂，只要掌握几个关键步骤就能顺利完成。下面是一份实用的操作指南，适合刚接触Docker的Java开发者。

准备工作：确保项目可以正常构建

在开始打包之前，首先要确认你的Spring Boot项目能通过Maven或Gradle正常构建出一个可运行的jar包。通常我们会使用mvn package或者gradle build来生成最终的jar文件。

常见问题：

• 本地构建没问题，但CI环境失败，可能是依赖版本不一致
• 没有配置正确的启动类导致jar无法运行

建议做法：

• 使用Maven时，在pom.xml中指定主类：

  
      com.example.demo.DemoApplication
  

• 构建前清理一次项目：mvn clean package

编写Dockerfile：定义镜像构建逻辑

接下来要创建一个Dockerfile，用来告诉Docker如何构建镜像。一般放在项目根目录下。

一个典型的Dockerfile内容如下：

# 使用基础JDK镜像
FROM openjdk:8-jdk-alpine

# 设置工作目录
WORKDIR /app

# 拷贝构建好的jar包进去
COPY target/demo-0.0.1-SNAPSHOT.jar app.jar

# 启动命令
ENTRYPOINT ["java", "-jar", "app.jar"]

注意事项：

• 确保jar包名称和路径与你实际构建的一致
• 如果用的是JDK 11以上版本，可能需要调整基础镜像，比如openjdk:11-jre-slim
• Alpine镜像体积小，但有时会缺少一些库，如果遇到兼容性问题可以换其他基础镜像

构建并运行Docker镜像

有了Dockerfile之后，就可以构建镜像了。在项目根目录执行以下命令：

docker build -t demo-app .

然后运行容器：

docker run -d -p 8080:8080 --name myapp demo-app

常用调试技巧：

• 查看容器日志：docker logs myapp
• 进入容器内部排查问题：docker exec -it myapp sh
• 如果应用没起来，先检查jar是否被正确复制、是否有权限问题

可选优化：使用多阶段构建减少镜像体积

如果你希望进一步减小镜像大小，可以使用多阶段构建。例如：

# 第一阶段：构建jar包
FROM maven:3.8.4-jdk-8 AS builder
WORKDIR /app
COPY . .
RUN mvn clean package

# 第二阶段：运行jar包
FROM openjdk:8-jdk-alpine
WORKDIR /app
COPY --from=builder /app/target/demo-0.0.1-SNAPSHOT.jar app.jar
ENTRYPOINT ["java", "-jar", "app.jar"]

好处是不需要把Maven和源码留在最终镜像里，安全性更高，体积更小。

基本上就这些。按照这个流程操作，大多数Spring Boot项目都能顺利打成Docker镜像。过程中可能会遇到一些细节问题，比如端口映射不对、jar找不到，但只要一步步排查，都不难解决。