Spring Boot 项目容器化部署核心是将应用、JRE和配置打包为可移植镜像,通过Docker启动实现环境一致性;需准备JDK 17、Maven 3.6+、Docker 4.x+及IDEA 2021.2+,推荐多阶段Dockerfile构建精简安全镜像。

Spring Boot 项目容器化部署,核心是把应用、JRE 和运行时配置打包成可移植镜像,再用 Docker 启动。整个过程不依赖服务器环境,本地构建好就能一键运行,彻底告别“在我机器上是好的”这类问题。
准备基础环境
确保以下四项已就绪,版本匹配能避免 80% 的构建失败:
- JDK 17(Spring Boot 3.x 必需;2.x 可用 8 或 11)
- Maven 3.6+(用于 clean package 构建 jar)
- Docker Desktop 4.x+(Windows/macOS 推荐;Linux 用 Docker Engine 20.10+)
- IDEA 2021.2+(自带 Docker 插件,支持图形化管理容器)
特别注意:Docker Desktop 安装后,需在 Settings → General → Expose daemon on tcp://localhost:2375 打勾,否则 IDEA 无法连接 Docker 守护进程。
编写生产级 Dockerfile
推荐使用多阶段构建,分离编译与运行环境,大幅减小镜像体积、提升安全性。以下是一个兼顾精简与实用的模板:
# 构建阶段:编译代码 FROM maven:3.9.6-eclipse-temurin-17 AS builder WORKDIR /build COPY . . RUN --mount=type=cache,target=/root/.m2 mvn clean package -DskipTests <h1>运行阶段:仅含 JRE 和 jar</h1><p>FROM eclipse-temurin:17-jre-alpine RUN addgroup -S app && adduser -S app -u 1001 -G app USER app WORKDIR /app COPY --from=builder /build/target/*.jar app.jar COPY --from=builder /build/src/main/resources ./config ENV TZ=Asia/Shanghai ENV JAVA_OPTS="-Xms256m -Xmx512m -Djava.security.egd=file:/dev/./urandom" EXPOSE 8080 ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]
关键点说明:
- 用
alpine基础镜像替代 full JDK,镜像体积通常压缩到 100MB 左右 - 显式创建非 root 用户(
app),避免容器以 root 权限运行带来的安全风险 -
COPY --from=builder只复制最终 jar 和配置,不带源码、Maven 缓存等冗余内容 -
ENTRYPOINT使用sh -c形式,确保 JVM 能正确接收 SIGTERM 信号,支持优雅停机
构建并运行容器
在项目根目录执行以下命令即可完成全流程:
-
构建镜像:
docker build -t my-springboot-app:v1 . -
启动容器:
docker run -d -p 8080:8080 --name myapp --restart always my-springboot-app:v1 -
验证服务:
curl http://localhost:8080/actuator/health(需启用 Actuator)
常用参数含义:
-
-d:后台运行 -
-p 8080:8080:主机端口映射到容器端口 -
--restart always:系统重启或容器异常退出后自动拉起 -
--name myapp:指定容器名,便于后续管理(如docker logs myapp)
灵活注入运行时配置
不要把数据库地址、密码等写死在代码或 jar 包里。Spring Boot 支持通过环境变量覆盖 application.yml 中的占位符,例如:
spring:
datasource:
url: jdbc:mysql://${DB_HOST:localhost}:${DB_PORT:3306}/mydb
username: ${DB_USER:root}
password: ${DB_PASSWORD:}
启动时传入变量即可动态生效:
- 单次调试:
docker run -e DB_HOST=192.168.1.100 -e DB_USER=admin ... - 批量管理:
echo "DB_HOST=192.168.1.100\nDB_USER=admin" > .env,再执行docker run --env-file .env ... - 团队协作:
docker-compose.yml中统一定义environment或env_file字段
敏感信息(如密码)建议配合 Docker Secrets(Swarm)或 K8s Secret 管理,不直接暴露在命令行或文件中。


















