当前位置：首页 > news >正文

springboot分层打包，减少重复构建和传输的开销

news 来源：原创 2025/5/2 6:51:12

在 Spring Boot 中，分层打包（Layered Packaging） 是一种优化策略，特别针对 容器化部署（如 Docker） 的场景设计。它的核心思想是将应用的不同部分（依赖、资源、代码等）划分为独立的层（Layer），利用容器镜像的分层缓存机制，减少重复构建和传输的开销。

分层打包的作用

提升 Docker 镜像构建效率
- 如果应用代码变动但依赖未变，Docker 只需重新构建代码层，而依赖层可以直接复用缓存。
- 减少镜像体积和构建时间，尤其适用于 CI/CD 流水线。
优化镜像层结构
- 将频繁变动的层（如应用代码）放在上层，稳定层（如依赖）放在下层，充分利用 Docker 的层缓存机制。
减少重复传输
- 在 Kubernetes 等集群中，节点间拉取镜像时，未变化的层可直接复用本地缓存。

分层结构

Spring Boot 默认将应用分为以下 4 个层：

层名	内容	变动频率
dependencies	第三方依赖（如 `spring-core`, `logback`）	低
spring-boot-loader	Spring Boot 的类加载器（`JarLauncher` 等）	低
snapshot-dependencies	快照版本的依赖（如 `1.0.0-SNAPSHOT`）	中
application	应用代码、配置文件（`src/main/**`）	高

如何启用分层打包？

1. Maven 配置

在 pom.xml 中启用分层：

org.springframework.boot spring-boot-maven-plugin true

2. Gradle 配置

在 build.gradle 中启用分层：

bootJar {
layered {
enabled = true
}
}

分层结果

打包后生成的 JAR 文件中会包含一个 layers.idx 文件，定义各层的内容：

“dependencies”:
- “BOOT-INF/lib/spring-core-6.1.0.jar”
- “BOOT-INF/lib/logback-classic-1.4.14.jar”
“spring-boot-loader”:
- “org/”
“snapshot-dependencies”:
- “BOOT-INF/lib/my-snapshot-lib-1.0.0-SNAPSHOT.jar”
“application”:
- “BOOT-INF/classes/”
- “BOOT-INF/config/”

与 Docker 结合使用

通过分层打包，可以编写高效的 Dockerfile：

使用分层构建

FROM eclipse-temurin:17-jre as builder
WORKDIR application
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
RUN java -Djarmode=layertools -jar app.jar extract

正式镜像

FROM eclipse-temurin:17-jre
WORKDIR application
COPY --from=builder application/dependencies/ ./
COPY --from=builder application/spring-boot-loader/ ./
COPY --from=builder application/snapshot-dependencies/ ./
COPY --from=builder application/application/ ./
ENTRYPOINT [“java”, “org.springframework.boot.loader.JarLauncher”]

命令 RUN java -Djarmode=layertools -jar app.jar extract 是 Spring Boot 分层打包（Layered Packaging）中与 Docker 镜像构建 结合使用的关键步骤，其核心作用是将 Spring Boot 的可执行 JAR 文件按预定义的分层结构解压到指定目录。以下是详细解释：

命令分解

部分	说明
`java -jar app.jar`	运行 Spring Boot 生成的 Fat JAR 文件（包含所有依赖和代码）。
`-Djarmode=layertools`	设置 JVM 参数，启用 Spring Boot 的 `layertools` 模式。
`extract`	在 `layertools` 模式下执行的命令，表示将 JAR 中的分层内容解压到文件系统。

关键步骤

使用 layertools 工具解压分层后的内容。
按层顺序复制到镜像中，依赖层（稳定）先复制，应用层（易变）最后。

自定义分层

如果需要调整默认分层逻辑，可以通过 layers.xml（Maven）或自定义 Layers 接口（Gradle）实现。例如：

<!-- src/main/layers.xml -->
<layers xmlns="http://www.springframework.org/schema/boot/layers"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://www.springframework.org/schema/boot/layers https://www.springframework.org/schema/boot/layers/layers-3.2.xsd"><application><into layer="application"><include>com/example/**</include></into></application><dependencies><into layer="snapshot-dependencies"><include>*:*:*SNAPSHOT</include></into><into layer="dependencies"/></dependencies>
</layers>