Java Spring Boot 项目 Docker 容器化部署教程

在现代微服务架构中，容器化部署已成为主流。通过 Docker，我们可以将 Spring Boot 应用及其依赖打包成镜像，实现"一次构建，到处运行"。下面以一个典型的 Spring Boot 项目为例，演示如何编写 Dockerfile 并完成部署。

1. 项目准备

项目结构 ：典型的 Maven Spring Boot 项目，主模块为 yudao-server
工具链 ：
- JDK 17（运行时使用 JRE）
- Maven 3.9+
- Docker 20.10+
忽略文件 ：在 .dockerignore 中排除 .git、target/、node_modules/ 等无关目录，减少构建上下文。

dockerignore 复制代码

.git
.gitignore
.idea/
.vscode/
node_modules/
yudao-ui/
.image/
target/
*/target/
*.log
*.iml
*.swp
*.bak
*.tmp
*.DS_Store

2. 多阶段 Dockerfile

采用 多阶段构建，第一阶段编译打包，第二阶段生成精简运行镜像：

dockerfile 复制代码

# -------------------------------
# 构建阶段：使用 Maven 构建产物
# -------------------------------
FROM maven:3.9.6-eclipse-temurin-17 AS builder

WORKDIR /build

# 复制项目源码（通过 .dockerignore 控制粒度）
COPY . .

# 使用 BuildKit 缓存 Maven 仓库，加速依赖下载
RUN --mount=type=cache,target=/root/.m2 \
    mvn -B clean package -DskipTests

# -------------------------------
# 运行阶段：构建精简运行镜像
# -------------------------------
FROM eclipse-temurin:17-jre-alpine

# 安全性：创建非 root 用户
RUN addgroup -S sdkj && adduser -S sdkj -G sdkj

WORKDIR /app

# 拷贝构建产物（统一命名为 app.jar）
COPY --from=builder /build/yudao-server/target/*.jar ./app.jar

# 可选：复制配置文件目录（支持挂载覆盖）
COPY --from=builder /build/yudao-server/src/main/resources ./config

# 创建日志目录并赋权，避免 logback 写文件时报错
RUN mkdir -p /app/logs && chown -R sdkj:sdkj /app/logs

# 设置时区
ENV TZ=Asia/Shanghai

# JVM 参数（可通过 docker run -e JAVA_OPTS=... 覆盖）
ENV JAVA_OPTS="-Xms512m -Xmx1024m -Djava.security.egd=file:/dev/./urandom"

# Spring Profile（可通过 docker run -e SPRING_PROFILE=dev 覆盖）
ENV SPRING_PROFILE=prod

# 暴露端口（默认 48087）
EXPOSE 48087

# 使用非 root 用户运行
USER sdkj

# 启动命令（支持挂载配置目录）
ENTRYPOINT ["sh", "-c"]
CMD ["exec java $JAVA_OPTS -jar app.jar $ARGS"]

亮点：

BuildKit 缓存 Maven 仓库，加速依赖下载
非 root 用户运行，提升安全性
日志目录预创建并赋权，避免 logback 报错
环境变量可覆盖，灵活配置 JVM 参数和 Spring Profile

3. 构建与运行

构建镜像

bash 复制代码

docker build -t myapp:1.0 .

运行容器

bash 复制代码

docker run -d \
  -p 48087:48087 \
  -e JAVA_OPTS="-Xms256m -Xmx512m" \
  -e SPRING_PROFILE=dev \
  -v /opt/config:/app/config \
  -v /opt/logs:/app/logs \
  myapp:1.0

挂载配置目录：支持覆盖默认配置
挂载日志目录：日志持久化到宿主机
环境变量覆盖：灵活调整运行参数

4. 常见问题

问题	解决方案
构建慢	使用 BuildKit 缓存 Maven 依赖
日志写入失败	确认 `/app/logs` 权限已赋给非 root 用户
配置未生效	检查 `SPRING_PROFILE` 环境变量是否正确
容器时区错误	确认 `TZ=Asia/Shanghai` 已设置

5. 总结

通过 多阶段构建 + 非 root 用户 + 配置挂载 ，我们实现了一个 安全、轻量、可配置 的 Spring Boot 容器化方案。

这种方式不仅适合本地开发，也能无缝对接 CI/CD 流水线（如 GitLab CI/CD + Harbor 推送）。