SpringBoot项目docker分层镜像构建案例_Java

摘要：本文主要介绍spring boot项目的docker镜像分层构建，分为外部依赖和内部依赖和项目classes依赖，让docker构建的时候，可以使用之前的缓存，加快构建速度和测试环境镜像拉取速度。

为什么使用分层 docker 镜像？

传统的 docker 镜像构建方式会将整个应用程序 jar/war 文件复制到一个层中。当你修改代码时，整个层都会失效，导致 docker 必须重新构建整个应用程序层，即使只是做了微小的代码更改。

通过我们的分层方法，我们将以下内容分离：

外部依赖（第三方库）
内部依赖（公司特定库）
应用程序代码（实际业务逻辑）

这样，当你修改代码时，只需要重新构建应用程序代码层，而依赖层可以从缓存中重用。

maven 插件配置详解

<build>
  <plugins>
    <plugin>
      <groupid>org.apache.maven.plugins</groupid>
      <artifactid>maven-dependency-plugin</artifactid>
      <executions>
        <execution>
          <id>copy-external-dependencies</id>
          <phase>package</phase>
          <goals>
            <goal>copy-dependencies</goal>
          </goals>
          <configuration>
            <outputdirectory>${project.build.directory}/lib/external</outputdirectory>
            <includescope>compile</includescope>
            <excludegroupids>cn.hutool</excludegroupids>
          </configuration>
        </execution>

        <execution>
          <id>copy-internal-dependencies</id>
          <phase>package</phase>
          <goals>
            <goal>copy-dependencies</goal>
          </goals>
          <configuration>
            <outputdirectory>${project.build.directory}/lib/internal</outputdirectory>
            <includescope>compile</includescope>
            <includegroupids>cn.hutool</includegroupids>
          </configuration>
        </execution>
      </executions>
    </plugin>
    <plugin>
      <groupid>org.apache.maven.plugins</groupid>
      <artifactid>maven-compiler-plugin</artifactid>
      <configuration>
        <source>21</source>
        <target>21</target>
        <encoding>utf-8</encoding>
        <!-- 如果使用预览特性 -->
        <compilerargs>
          <arg>--enable-preview</arg>
        </compilerargs>
        <release>21</release>
      </configuration>
    </plugin>
  </plugins>
</build>

工作原理

1. maven 依赖分离插件配置详解

我们的 pom.xml 使用 maven-dependency-plugin 在构建过程中分离依赖。该插件包含两个执行配置：

外部依赖复制配置

<execution>
    <id>copy-external-dependencies</id>
    <phase>package</phase>
    <goals>
        <goal>copy-dependencies</goal>
    </goals>
    <configuration>
        <outputdirectory>${project.build.directory}/lib/external</outputdirectory>
        <includescope>compile</includescope>
        <excludegroupids>cn.hutool</excludegroupids>
    </configuration>
</execution>

配置参数说明：

<id>: 执行的唯一标识符

<phase>: 绑定到 maven 生命周期的 package 阶段

<goals>: 执行的目标是 copy-dependencies

<configuration>: 配置详情

<outputdirectory>: 输出目录，${project.build.directory} 是 target 目录
<includescope>: 包含作用域为 compile 的依赖
<excludegroupids>: 排除 groupid 为 cn.hutool 的依赖（将其视为内部依赖）

内部依赖复制配置

<execution>
    <id>copy-internal-dependencies</id>
    <phase>package</phase>
    <goals>
        <goal>copy-dependencies</goal>
    </goals>
    <configuration>
        <outputdirectory>${project.build.directory}/lib/internal</outputdirectory>
        <includescope>compile</includescope>
        <includegroupids>cn.hutool</includegroupids>
    </configuration>
</execution>

配置参数说明：

<id>: 执行的唯一标识符

<phase>: 同样绑定到 maven 生命周期的 package 阶段

<goals>: 执行的目标也是 copy-dependencies

<configuration>: 配置详情

<outputdirectory>: 输出目录为 target/lib/internal
<includescope>: 包含作用域为 compile 的依赖
<includegroupids>: 只包含 groupid 为 cn.hutool 的依赖（作为内部依赖处理）

通过这两个执行配置，maven 会在 package 阶段自动将依赖分别复制到对应的目录中：

target/lib/external/ - 第三方依赖（排除了 cn.hutool）
target/lib/internal/ - 内部/公司特定依赖（只有 cn.hutool）
target/classes/ - 编译后的应用程序代码

2. 分层 dockerfile 详解

我们的 dockerfile 通过首先复制依赖来利用 docker 层缓存：

from eclipse-temurin:21-jre-alpine
workdir /app

# 1. 复制外部依赖（很少更改）
copy target/lib/external/*.jar ./lib/external/

# 2. 复制内部依赖（偶尔更改）
copy target/lib/internal/*.jar ./lib/internal/

# 3. 复制应用程序类（经常更改）
copy target/classes ./classes

expose 8080

env custom_opts="-xms256m -xmx768m"
env java_opts="--enable-preview -xx:+useserialgc"
entrypoint ["sh", "-c", "java $custom_opts $java_opts -cp /app/classes:/app/lib/external/*:/app/lib/internal/* com.example.layer.sp3layerapplication"]

dockerfile 配置说明：

from eclipse-temurin:21-jre-alpine: 使用轻量级的 alpine linux 上的 temurin jdk 21 运行时环境

workdir /app: 设置工作目录为 /app

copy target/lib/external/*.jar ./lib/external/: 将外部依赖复制到镜像中，这是最稳定的层

copy target/lib/internal/*.jar ./lib/internal/: 将内部依赖复制到镜像中，这层比外部依赖更可能变化

copy target/classes ./classes: 将应用程序类文件复制到镜像中，这层最容易发生变化

expose 8080: 暴露应用程序端口

env 指令设置 jvm 参数：

custom_opts: 自定义 jvm 参数，设置初始堆内存和最大堆内存
java_opts: java 虚拟机选项，启用预览特性和使用串行垃圾收集器

entrypoint: 定义容器启动时执行的命令，使用类路径包含所有依赖和应用程序类

类路径说明：
-cp /app/classes:/app/lib/external/*:/app/lib/internal/* 指定了类路径的顺序：

/app/classes: 应用程序编译后的类文件优先级最高
/app/lib/external/*: 外部依赖次之
/app/lib/internal/*: 内部依赖最后

这种顺序确保了应用程序类可以覆盖依赖中的同名类（如果需要的话），并且保证了正确的类加载顺序。

3. 构建过程详解

maven 构建生命周期集成

当执行 mvn package 命令时，maven 会按照以下顺序执行构建阶段：

validate - 验证项目正确性
compile - 编译源代码
test - 运行测试
package - 打包应用程序

在 package 阶段，maven-dependency-plugin 会自动执行我们配置的两个依赖复制任务：

首先执行 copy-external-dependencies，将外部依赖复制到 target/lib/external/
然后执行 copy-internal-dependencies，将内部依赖复制到 target/lib/internal/
同时，maven 默认会将编译后的类文件放在 target/classes/ 目录中

完整构建步骤

清理并打包应用程序：

mvn clean package

此命令会触发依赖分离过程，生成三个目录：

target/classes/ - 应用程序编译后的类文件
target/lib/external/ - 外部依赖 jar 文件
target/lib/internal/ - 内部依赖 jar 文件

构建 docker 镜像：

docker build -t sp3-layer .

docker 构建过程会按顺序创建四个层：

基础镜像层（eclipse-temurin:21-jre-alpine）
外部依赖层（copy target/lib/external/*.jar）
内部依赖层（copy target/lib/internal/*.jar）
应用程序类层（copy target/classes）

构建优化效果

由于 docker 的层缓存机制：

当只修改应用程序代码时，只有最后一层需要重建
当添加新的外部依赖时，需要重建外部依赖层及其后的所有层
当添加新的内部依赖时，需要重建内部依赖层和应用程序类层
只有基础镜像变更时，才需要完全重建

优势

更快的构建速度：代码更改时只需重新构建应用程序代码层
更小的传输量：推送到注册中心时，只传输更改的层
更好的缓存效果：依赖层在各个构建之间缓存并重用
减少带宽消耗：在 ci/cd 流水线中减少数据传输

版本更新工作流程

在应用程序中进行代码更改
运行 mvn clean package 仅重新编译更改的代码
运行 docker build -t sp3-layer:v2 . 构建新镜像
只有 target/classes 层会被重新构建
只将更改的层推送到容器注册中心

配置自定义指南

要将此配置应用于其他项目，您需要根据项目的依赖结构调整配置：

修改依赖分组

如果您有不同的内部依赖，需要修改 excludegroupids 和 includegroupids 配置：

<!-- 外部依赖配置 -->
<excludegroupids>com.yourcompany,org.another.internal.group</excludegroupids>
<!-- 内部依赖配置 -->
<includegroupids>com.yourcompany,org.another.internal.group</includegroupids>

最佳实践

顺序很重要：首先复制不经常更改的层
最小化层数：只分离实际在不同频率下更改的内容
多阶段构建：考虑与多阶段构建结合使用以获得更小的最终镜像
缓存失效：了解 docker 的层缓存机制以最大化收益

这种方法可以显著减少 ci/cd 流水线中的构建时间，并在部署更新时最小化网络传输。

到此这篇关于springboot项目docker分层镜像构建案例的文章就介绍到这了,更多相关springboot docker分层镜像内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！

SpringBoot项目docker分层镜像构建案例

2026年02月10日 • Java •我要评论