SpringBoot结合Docker进行容器化处理指南

 更新时间:2025年07月10日 16:14:39   作者:超级小忍  
在当今快速发展的软件工程领域,Spring Boot 和 Docker 已经成为现代 Java 开发者的必备工具,本文将深入讲解如何将一个 Spring Boot 应用进行容器化处理,希望对大家有所帮助

前言

在当今快速发展的软件工程领域,Spring BootDocker 已经成为现代 Java 开发者的必备工具。Spring Boot 简化了 Java 应用的开发和配置过程,而 Docker 提供了一种轻量级、可移植的容器化解决方案,使得应用可以在不同环境中保持一致性。

本文将深入讲解如何将一个 Spring Boot 应用进行容器化处理,包括:

  • 构建 Spring Boot 可执行 JAR 包
  • 编写适用于生产环境的 Dockerfile
  • 使用 Docker Compose 管理多服务依赖
  • 将镜像推送到私有仓库(如 Harbor 或 Docker Hub)
  • 部署到云平台(如阿里云 ECS + 容器服务)
  • 最佳实践与性能优化建议

一、为什么选择 Spring Boot + Docker

1. 快速部署与简化运维

Spring Boot 内置了 Tomcat、Jetty 等 Web 容器,可以以独立的 JAR 包形式运行。配合 Docker,我们可以将整个应用打包为一个“即插即用”的镜像,避免传统部署中的复杂配置。

2. 环境一致性保障

Docker 容器提供了一个隔离的运行环境,确保无论是在本地开发、测试服务器还是生产环境,应用程序的行为都一致。

3. 支持 DevOps 和 CI/CD 流程

Docker 镜像易于版本管理,非常适合集成到自动化构建和部署流程中,比如 Jenkins、GitLab CI、GitHub Actions 等。

4. 微服务架构的理想搭档

如果你正在构建微服务架构,每个服务都可以使用 Docker 进行封装,通过 Kubernetes 等编排工具实现统一管理、弹性伸缩和自动恢复。

二、前置准备

在开始之前,请确保你已安装以下工具:

工具版本要求
JDK17+
Maven3.6+
Docker20.10+
Docker Compose2.x+

推荐使用 Spring Initializr 创建一个基础项目,选择如下依赖:

  • Spring Web
  • Spring Data JPA(可选)
  • MySQL Driver(可选)

三、创建 Spring Boot 项目

1. 使用 Spring Initializr 创建项目

访问 https://start.spring.io/,填写如下信息:

  • Project: Maven
  • Language: Java
  • Spring Boot Version: 3.0+
  • Group: com.example
  • Artifact: springboot-docker-demo
  • Dependencies:
    • Spring Web
    • Spring Data JPA(可选)
    • MySQL Driver(可选)

点击 “Generate” 下载项目压缩包并解压。

2. 添加简单功能

打开 src/main/java/com/example/springbootdockerdemo/controller/HelloController.java,添加如下代码:

@RestController
public class HelloController {

    @GetMapping("/")
    public String hello() {
        return "Hello from Spring Boot in Docker!";
    }
}

3. 配置数据库连接(可选)

如果启用了 JPA 和 MySQL Driver,可以在 application.properties 中添加如下配置:

spring.datasource.url=jdbc:mysql://localhost:3306/mydb?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=root
spring.jpa.hibernate.ddl-auto=update

四、构建可执行 JAR 包

1. 检查 Maven 插件配置

确保 pom.xml 中包含如下插件:

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

2. 执行 Maven 打包命令

mvn clean package

打包完成后,在 target/ 目录下会生成一个名为 springboot-docker-demo-0.0.1-SNAPSHOT.jar 的文件。

五、编写 Dockerfile

在项目根目录下新建 Dockerfile 文件,内容如下:

# 使用官方 OpenJDK 镜像作为基础镜像
FROM openjdk:17-jdk-slim

# 设置工作目录
WORKDIR /app

# 复制本地 JAR 文件到容器内
COPY target/springboot-docker-demo-0.0.1-SNAPSHOT.jar app.jar

# 设置 JVM 参数(可选)
ENV JAVA_OPTS=""

# 容器启动时执行命令
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]

提示:你可以通过 -e JAVA_OPTS="-Xms512m -Xmx1g" 在运行时指定 JVM 参数。

六、构建并运行 Docker 镜像

1. 构建镜像

docker build -t springboot-docker-demo .

2. 查看镜像列表

docker images

3. 启动容器

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

现在访问 http://localhost:8080,你应该能看到输出的欢迎信息。

七、使用 Docker Compose 管理多服务依赖

如果你的应用需要连接数据库或其他服务,可以使用 docker-compose.yml 来统一管理多个容器。

示例 docker-compose.yml 文件

version: "3"
services:
  springboot-app:
    image: springboot-docker-demo
    build: .
    ports:
      - "8080:8080"
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://db:3306/mydb
      SPRING_DATASOURCE_USERNAME: root
      SPRING_DATASOURCE_PASSWORD: root
    depends_on:
      - db

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: mydb
    ports:
      - "3306:3306"
    volumes:
      - mysql_data:/var/lib/mysql

volumes:
  mysql_data:

启动服务

docker-compose up -d

八、推送镜像到远程仓库

1. 登录 Docker Hub

docker login

2. 给镜像打标签

docker tag springboot-docker-demo your-dockerhub-username/springboot-docker-demo:latest

3. 推送镜像

docker push your-dockerhub-username/springboot-docker-demo:latest

之后你就可以在其他机器上拉取该镜像:

docker pull your-dockerhub-username/springboot-docker-demo

九、部署到云平台(以阿里云 ECS 为例)

步骤概览

  • 在阿里云控制台购买一台 ECS 实例(推荐 Ubuntu 20.04 LTS)
  • 登录 ECS 并安装 Docker、Docker Compose
  • 拉取镜像并运行容器
  • 配置安全组开放 8080 端口
  • 访问公网 IP 即可访问你的 Spring Boot 应用

安装 Docker 命令参考

sudo apt update
sudo apt install docker.io
sudo systemctl enable docker
sudo systemctl start docker

# 安装 Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/v2.23.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

十、高级技巧与最佳实践

1. 分层构建优化镜像大小

FROM maven:3.8.6-jdk-17 AS build
WORKDIR /app
COPY . .
RUN mvn clean package

FROM openjdk:17-jdk-slim
WORKDIR /app
COPY --from=build /app/target/*.jar app.jar
ENTRYPOINT ["java", "-jar", "app.jar"]

2. 使用.dockerignore文件排除不必要的文件

创建 .dockerignore 文件:

.git
.gitignore
README.md
*.log
target/

3. 使用健康检查探针

HEALTHCHECK CMD curl --fail http://localhost:8080/actuator/health || exit 1

4. 使用日志驱动收集日志

docker run \
  --log-driver=json-file \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  -d -p 8080:8080 springboot-docker-demo

十一、总结

通过本文的学习,你应该已经掌握了以下技能:

  • 创建并打包 Spring Boot 应用
  • 编写适用于生产环境的 Dockerfile
  • 使用 Docker Compose 管理多服务应用
  • 推送镜像到 Docker Hub 并部署到云服务器
  • 掌握一些提升效率和稳定性的最佳实践

掌握 Spring Boot 与 Docker 的结合,是迈向现代化应用开发和部署的重要一步。它不仅提升了开发效率,也为未来的云原生架构奠定了坚实基础。

到此这篇关于SpringBoot结合Docker进行容器化处理指南的文章就介绍到这了,更多相关SpringBoot Docker容器化内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Java遍历读取Excel固定的单元格实现方式

    Java遍历读取Excel固定的单元格实现方式

    使用ApachePOI读取Excel需先添加依赖,再编写核心代码处理数据,如图所示,总结个人经验,供参考并支持脚本之家
    2025-09-09
  • Java中高效的对象映射库Orika的用法详解

    Java中高效的对象映射库Orika的用法详解

    Orika是一个高效的Java对象映射库,专门用于在Java应用程序中简化对象之间的转换,下面就跟随小编一起来深入了解下Orika的具体使用吧
    2024-11-11
  • Java中的ThreadPoolExecutor线程池原理细节解析

    Java中的ThreadPoolExecutor线程池原理细节解析

    这篇文章主要介绍了Java中的ThreadPoolExecutor线程池原理细节解析,ThreadPoolExecutor是一个线程池,最多可使用7个参数来控制线程池的生成,使用线程池可以避免创建和销毁线程的资源损耗,提高响应速度,并且可以管理线程池中线程的数量和状态等等,需要的朋友可以参考下
    2023-12-12
  • Java多线程下的其他组件之CyclicBarrier、Callable、Future和FutureTask详解

    Java多线程下的其他组件之CyclicBarrier、Callable、Future和FutureTask详解

    这篇文章主要介绍了Java多线程下的其他组件之CyclicBarrier、Callable、Future和FutureTask详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-07-07
  • spring无法引入注解及import org.springframework.web.bind.annotation.*报错的解决

    spring无法引入注解及import org.springframework.web.bind.annota

    本文主要介绍了spring无法引入注解及import org.springframework.web.bind.annotation.*报错的解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-06-06
  • java实现猜字母游戏

    java实现猜字母游戏

    这篇文章主要为大家详细介绍了java实现猜字母小游戏,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-03-03
  • Java算法之快速排序举例详解

    Java算法之快速排序举例详解

    这篇文章主要介绍了Java算法之快速排序的相关资料,快速排序是一种高效的排序算法,通过递归的方式将待排序数组分成小部分进行排序,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-04-04
  • spring boot 常见http请求url参数获取方法

    spring boot 常见http请求url参数获取方法

    这篇文章主要介绍了spring boot 常见http请求url参数获取,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-03-03
  • Sentinel整合Feign流程详细讲解

    Sentinel整合Feign流程详细讲解

    要想整合Feign,首先要了解Feign的使用以及执行过程,然后看 Sentinel如何整合进去,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-08-08
  • springboot接收json数据时,接收到空值问题

    springboot接收json数据时,接收到空值问题

    这篇文章主要介绍了springboot接收json数据时,接收到空值问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-05-05

最新评论