Docker部署Java项目全流程解析（实战指南）

一、环境准备阶段

1 安装Docker环境

# CentOS系统安装命令
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io

解释：通过官方仓库安装最新稳定版Docker，-y参数自动确认安装依赖

2 验证安装结果

docker --version && docker run hello-world

检测Docker版本及基础运行能力，成功显示版本信息并下载测试镜像即表明环境正常

二、项目结构标准化

推荐目录结构：

/project-root
├── src
├── target
│   └── demo.jar  # Maven/Gradle打包产物
├── Dockerfile    # 镜像构建文件
└── docker-compose.yml  # 服务编排文件（可选）

关键点：确保打包生成的可执行JAR/WAR文件路径正确

三、Dockerfile编写规范

# 阶段1：构建环境
FROM maven:3.8.6-jdk-11 AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn package -DskipTests

# 阶段2：运行环境
FROM openjdk:11-jre-slim
EXPOSE 8080
VOLUME /tmp
COPY --from=builder /app/target/demo.jar /app.jar
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

逐行解析：

• FROM maven:3.8.6-jdk-11 AS builder：使用带Maven的JDK镜像作为构建环境
• RUN mvn dependency:go-offline：提前下载依赖加速后续构建
• FROM openjdk:11-jre-slim：使用轻量级JRE镜像作为运行时环境
• VOLUME /tmp：挂载临时目录提升IO性能
• -Djava.security.egd：解决Linux熵池不足导致的启动延迟问题

四、镜像构建与运行

1 构建镜像

docker build -t java-demo:1.0 . 

-t指定镜像名称和标签，.表示Dockerfile所在目录

2 启动容器

docker run -d -p 8080:8080 --name demo-container java-demo:1.0

参数说明：

• -d：后台运行模式
• -p 8080:8080：主机端口映射到容器端口
• --name：指定容器名称

五、生产级优化方案

1 多阶段构建
通过分离构建环境和运行环境，可减少镜像体积（原始镜像1.2GB → 优化后180MB）

2 时区配置

ENV TZ=Asia/Shanghai
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

3 JVM参数调优

ENTRYPOINT ["java","-Xms512m","-Xmx2048m","-XX:+UseG1GC","-jar","/app.jar"]

内存设置根据实际物理机配置调整，G1垃圾回收器适合大内存应用

六、服务验证流程

1 检查容器状态

docker ps -a | grep demo-container

确认STATUS列为Up表示运行正常

2 查看实时日志

docker logs -f --tail 100 demo-container

-f持续跟踪日志，--tail 100显示最后100行

3 进入容器调试

docker exec -it demo-container /bin/bash

用于检查文件系统、环境变量等运行时状态

七、进阶部署方案

1 docker-compose编排

version: '3.8'
services:
  java-app:
    image: java-demo:1.0
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
    networks:
      - app-network

networks:
  app-network:
    driver: bridge

支持多服务协同部署，实现网络隔离、环境变量集中管理

2 健康检查机制

HEALTHCHECK --interval=30s --timeout=3s \
  CMD curl -f http://localhost:8080/actuator/health || exit 1

配合Spring Boot Actuator实现应用健康监测

八、常见问题排查

镜像体积过大

• 解决方案：使用 .dockerignore文件排除无关文件

# .dockerignore示例
.git
*.iml
target/*.jar

端口冲突问题

netstat -tulnp | grep 8080  # 检查端口占用
lsof -i :8080              # 查看占用进程

依赖缺失报错

• 确认构建阶段 mvn package是否成功生成完整JAR
• 检查 COPY指令路径是否准确

通过以上标准化流程，可实现Java应用的容器化部署效率提升60%以上。实际生产环境中建议结合CI/CD流水线实现自动化构建部署，并配置监控告警系统保障服务稳定性。