Spring Boot Jar 包秒变 Docker 镜像实现多环境部署

liuian 2025-07-09 14:16 62 浏览

你是否在互联网大厂后端开发工作中，遇到过这样的困扰？当完成一个 Spring Boot 项目开发，准备将 Jar 包部署到不同环境时，却发现各个环境依赖不同、配置复杂，部署过程繁琐又容易出错，不仅耗费大量时间，还经常出现莫名其妙的问题，影响项目进度？相信不少后端开发人员都有过类似的糟心体验。

在如今互联网快速发展的时代，互联网大厂的业务规模庞大，对应用的部署和运维要求极高。Spring Boot 以其便捷性成为后端开发的热门框架，而将 Spring Boot 的 Jar 包打包成 Docker 镜像，实现多环境部署，是提升开发效率、保证环境一致性的关键。传统的部署方式，在面对开发、测试、生产等不同环境时，往往需要手动配置各种依赖和参数，一旦出现环境差异，就会导致应用无法正常运行，不仅增加了开发和运维的工作量，还容易引发生产事故，影响用户体验和公司业务。

Spring Boot 项目打包

Spring Boot 项目主流构建工具为 Maven 和 Gradle ，以 Maven 为例，其核心配置文件pom.xml中，Spring Boot 的spring - boot - maven - plugin插件起着关键作用。执行mvn clean package命令时，clean阶段会删除之前编译生成的target目录，保证项目 “干净” 编译；package阶段则按照pom.xml中定义的依赖和插件规则，进行源码编译、资源处理、依赖打包等操作，最终在target目录下生成可执行的*.jar文件。

为确保 Jar 包的正确性和完整性，我们可以通过执行java -jar target/your - project - name.jar在本地运行测试。若项目包含多个模块，需注意模块间的依赖关系，在父模块的pom.xml中统一管理依赖版本，子模块继承父模块配置，避免版本冲突。

编写 Dockerfile

指令	说明	示例
FROM	指定基础镜像	FROM openjdk:11-jre-slim
WORKDIR	设置工作目录	WORKDIR /app
COPY	复制文件到容器	COPY target/your-project-name.jar app.jar
EXPOSE	声明端口	EXPOSE 8080
CMD	定义容器启动命令	CMD ["java", "-jar", "app.jar"]

基础镜像选择openjdk:11-jre-slim，它基于 Alpine Linux 构建，体积小巧，适合生产环境。若项目依赖特殊的库或运行环境，可在Dockerfile中添加RUN指令安装，如RUN apk add --no-cache your - dependency （Alpine Linux）或RUN apt-get update && apt-get install -y your - dependency （Debian/Ubuntu）。

此外，可通过添加.dockerignore文件，排除无需打包进镜像的文件，如target目录、日志文件、node_modules等，加快镜像构建速度，文件内容示例如下：

target
logs
node_modules

构建 Docker 镜像

构建镜像命令docker build -t your-image-name.中，-t参数用于为镜像打标签，格式为仓库名/镜像名:版本号，如registry.example.com/my - spring - boot - app:1.0 。若不指定版本号，默认使用latest 。

构建过程中，Docker 会根据Dockerfile的指令分层缓存。若指令未发生变化，后续构建将直接使用缓存，大大缩短构建时间。当镜像构建完成后，可使用docker images命令查看镜像列表，确认镜像是否构建成功。

运行 Docker 容器

运行容器命令docker run -d -p 8080:8080 --name your-container-name your-image-name中，-d参数使容器在后台运行；-p参数进行端口映射，前一个8080是宿主机端口，后一个8080是容器内端口，可根据实际需求修改，如-p 8081:8080 ；--name为容器命名，方便后续管理和操作。

若项目需要连接外部数据库、缓存等服务，可通过--link或--network参数配置容器网络。例如，使用docker network create my - network创建自定义网络，然后在运行容器时添加--network my - network参数，使容器加入该网络，实现与其他容器的通信。

多环境部署

Spring Boot 通过spring.profiles.active属性实现多环境配置切换。在src/main/resources目录下，创建application - dev.yml、application - test.yml、application - prod.yml等配置文件，分别配置不同环境的数据库连接（如spring.datasource.url ）、服务器地址、日志级别等参数。

在docker-compose.yml文件中，通过环境变量指定配置文件，示例如下：

version: '3'
services:
  my - spring - boot - app:
    image: your - image - name
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE = prod

也可使用docker run命令直接指定环境变量，如docker run -d -p 8080:8080 -e SPRING_PROFILES_ACTIVE = test --name your - container - name your - image - name 。