摘要：在当今互联网软件开发领域，Spring Boot 框架因其高效、便捷等特性，深受广大开发人员的喜爱。而将 Spring Boot 应用打包部署为容器镜像，借助容器技术的优势，能极大地提升应用部署的效率和稳定性，有效避免因环境差异导致的无法部署问题。接下来，让我

在当今互联网软件开发领域，Spring Boot 框架因其高效、便捷等特性，深受广大开发人员的喜爱。而将 Spring Boot 应用打包部署为容器镜像，借助容器技术的优势，能极大地提升应用部署的效率和稳定性，有效避免因环境差异导致的无法部署问题。接下来，让我们深入探讨这一过程。

随着微服务架构的盛行，应用的部署面临诸多挑战，其中环境不一致问题尤为突出。在开发、测试、生产等不同环境中，JDK 版本、依赖库、配置参数的差异，常常导致 “在我电脑上能跑，到了其他环境就不行” 的尴尬局面。Spring Boot 应用也不例外，传统的部署方式难以确保应用在不同环境中的稳定运行。

而容器化技术的出现，为这一难题提供了完美的解决方案。Docker 作为主流的容器化工具，可以将 Spring Boot 应用及其所有依赖项打包成一个独立的、可移植的容器镜像。这意味着，只要在任何支持 Docker 的环境中，都能以相同的方式运行该应用，真正实现了 “一次构建，到处运行”，极大地减少了环境相关的部署问题。

（一）环境安装

安装 Docker：根据你所使用的操作系统（如 Windows、MacOS、Linux），前往 Docker 官方网站（https://www.docker.com/get-started）下载并安装对应的 Docker 版本。安装完成后，在命令行中输入 “docker version”，若能正确输出版本信息，则说明 Docker 安装成功。

安装 Maven 或 Gradle：Spring Boot 项目构建通常依赖 Maven 或 gradle。若使用 Maven，可从 Maven 官方网站（https://maven.apache.org/download.cgi）下载并解压，然后配置好环境变量。对于 Gradle，同样从其官网（https://gradle.org/releases/）获取安装包进行安装和环境变量配置。在命令行中分别输入 “mvn -v” 和 “gradle -v” 可验证是否安装成功。

（二）Spring Boot 项目准备

确保你已经有一个开发完成且可正常运行的 Spring Boot 项目。如果没有，可以通过 Spring Initializr（https://start.spring.io/）快速创建一个。在创建过程中，根据项目需求选择相应的依赖，如 Web、数据库连接等依赖。创建完成后，下载项目压缩包并解压到本地开发环境。

（一）使用 Maven 打包

在 Spring Boot 项目的根目录下，打开命令行终端，执行以下命令：

该命令会首先清理项目中的旧构建文件（执行 “clean” 操作），然后将项目打包成一个可执行的 JAR 文件。打包完成后，生成的 JAR 文件通常位于项目的 “target” 目录下。例如，若你的项目名为 “demo”，生成的 JAR 文件可能是 “demo - 0.0.1 - SNAPSHOT.jar”。

你可以通过以下命令来验证 JAR 文件是否可以正常运行：

若应用能够成功启动，并在浏览器中访问对应的接口（假设项目中有暴露的接口）能得到正确响应，则说明 JAR 文件可正常工作。

（二）使用 Gradle 打包

如果项目使用 Gradle 构建，在项目根目录下的命令行中执行：

Gradle 同样会构建项目并生成 JAR 文件，生成的文件路径一般在 “build/libs” 目录下。同样可使用 “java -jar” 命令来验证生成的 JAR 文件能否正常运行。

在 Spring Boot 项目的根目录下，创建一个名为 “Dockerfile”（注意没有文件扩展名）的文件，用于定义如何构建 Docker 镜像。以下是一个基本的 Dockerfile 示例：

（一）Dockerfile 各部分详解

基础镜像选择：“FROM openjdk:11 - jre - slim” 指定了我们构建镜像的基础镜像。这里选择的是 OpenJDK 11 的精简运行时环境镜像，相比完整版，它体积更小，下载速度更快，并且启动应用时也更高效。

工作目录设置：“WORKDIR /app” 设置了容器内的工作目录为 “/app”。后续在 Dockerfile 中执行的操作，如复制文件、运行命令等，若未指定绝对路径，都将在这个工作目录下进行。这样做可以使文件管理更加清晰，也方便后续维护。

复制 JAR 文件：“COPY target/demo - 0.0.1 - SNAPSHOT.jar app.jar” 将我们在项目构建阶段生成的 JAR 文件从项目的 “target” 目录复制到容器内的 “/app” 目录下，并命名为 “app.jar”。这里的源路径 “target/demo - 0.0.1 - SNAPSHOT.jar” 需要根据你实际的项目 JAR 文件名进行修改。

端口暴露：“EXPOSE 8080” 声明了容器运行时会暴露 8080 端口。这一步主要是起到文档说明的作用，实际在运行容器时，还需要通过 “-p” 参数将容器端口映射到主机端口，才能从外部访问容器内的应用。

容器启动命令：“CMD ["java", "-jar", "app.jar"]” 定义了容器启动时要执行的命令，即运行我们的 Spring Boot 应用。这里的 “app.jar” 要与前面复制到容器内的 JAR 文件名一致。

在项目根目录下，打开命令行终端，执行以下命令来构建 Docker 镜像：

在这个命令中：

构建过程中，Docker 会根据 Dockerfile 中的指令逐步执行，从基础镜像开始，依次复制文件、执行命令等。构建完成后，你可以通过以下命令查看本地已有的 Docker 镜像列表：

在列出的镜像中，你应该能看到刚刚构建的 “your - spring - boot - app:latest” 镜像。

构建好镜像后，就可以运行容器来启动我们的 Spring Boot 应用了。执行以下命令：

在这个命令中：

运行上述命令后，若没有报错，说明容器已成功启动。你可以通过访问 “http://localhost:8080”（假设映射的是 8080 端口）来验证 Spring Boot 应用是否正常运行。如果应用正常，应该能看到与在本地开发环境中运行时相同的页面或接口响应。

（一）容器内存不足或 CPU 资源不足

问题表现：容器启动后，应用运行缓慢甚至无法正常运行，通过 Docker 命令查看容器状态时，发现内存或 CPU 使用率过高。

解决方法：可以通过修改 Docker 容器的启动参数来调整资源配置。例如，增加内存分配，使用以下命令：

这里 “--memory = 4g” 表示为容器分配 4GB 内存，你可以根据应用实际需求调整内存大小。对于 CPU 资源，可以通过 “--cpus” 参数来限制，如 “--cpus = 2” 表示分配 2 个 CPU 核心给容器。

（二）依赖库缺失或版本冲突

问题表现：容器启动过程中报错，提示某些依赖库找不到或版本不兼容。

解决方法：在项目的构建文件（如 Maven 的 pom.xml 或 Gradle 的 build.gradle）中，仔细检查依赖库的配置。确保所有依赖库的版本相互兼容，并且是项目所需的正确版本。如果是使用 Maven，可以通过执行 “mvn dependency:tree” 命令来查看项目的依赖树，找出可能存在问题的依赖。对于 Gradle，可使用 “gradle dependencies” 命令。如果发现有问题的依赖，及时在构建文件中调整版本或更换依赖库。

（三）端口占用或网络配置错误

问题表现：尝试启动容器时，提示端口已被占用，或者容器启动后，无法通过映射的端口访问应用。

解决方法：对于端口占用问题，首先使用命令查看是哪个进程占用了相应端口。在 Linux 或 MacOS 系统中，可以使用 “lsof -i : 端口号” 命令，如 “lsof -i :8080”；在 Windows 系统中，可以使用 “netstat -ano | findstr 端口号” 命令，如 “netstat -ano | findstr 8080”。找到占用端口的进程后，根据情况决定是否停止该进程，以释放端口。如果是网络配置错误，检查 Dockerfile 中端口暴露的设置是否与 Spring Boot 项目中应用的端口配置一致，同时确保在运行容器时，端口映射参数设置正确。

前面我们构建的 Docker 镜像虽然可以正常工作，但体积可能较大，因为基础镜像中包含了完整的 JDK 和构建依赖。通过多阶段构建，可以显著减小镜像体积。

多阶段构建的原理是将镜像构建过程分为多个阶段。第一阶段（构建阶段）：使用包含 Maven 或 Gradle 的镜像编译源码、打包 JAR 包；第二阶段（运行阶段）：仅复制第一阶段生成的 JAR 包到轻量级基础镜像（如 JRE）中，不包含构建工具。

以下是优化后的 Dockerfile 示例：

通过这种方式，最终生成的镜像体积会明显减小，下载和部署速度也会更快。

（二）自定义 JVM 参数

Spring Boot 应用的性能与 JVM 参数密切相关。我们可以在 Dockerfile 中通过 “ENTRYPOINT” 指令自定义 JVM 参数，如堆内存大小、GC 策略等。

以下是带 JVM 参数的 Dockerfile 片段：

你可以根据应用实际的内存使用情况和性能需求，调整这些 JVM 参数。

（三）健康检查

为了确保容器内的 Spring Boot 应用真正处于可用状态，我们可以添加健康检查。在 Dockerfile 中使用 “HEALTHCHECK” 指令来实现。

假设我们的 Spring Boot 应用添加了 Spring Boot Actuator 依赖，暴露了 “/actuator/health” 健康检查端点，那么可以在 Dockerfile 中添加如下健康检查配置：

这里 “--interval = 30s” 表示每隔 30 秒检查一次应用的健康状态；“--timeout = 3s” 表示每次检查的超时时间为 3 秒。如果检查失败（即 curl 命令返回非 0 状态码），容器将被标记为不健康。

通过以上步骤和优化方法，你可以将 Spring Boot 应用成功打包部署为容器镜像，并有效避免因环境异常导致的无法部署问题，让你的应用在各种环境中都能稳定、高效地运行。

来源：从程序员到架构师一点号