Spring Boot+Vue项目Docker容器化实战指南

1. 项目概述最近在帮朋友公司重构一个前后端分离的管理系统技术栈选用了Spring Boot Vue的组合。考虑到后续的部署维护成本决定采用Docker容器化方案。这种部署方式在实际生产环境中已经非常普遍但新手在初次尝试时往往会遇到各种坑。今天我就把这次实战中的完整流程和关键注意事项整理出来希望能帮到有类似需求的开发者。这个方案最大的优势在于环境隔离和快速部署。传统部署方式需要手动安装JDK、Nginx等依赖而Docker方案只需要几条命令就能完成全栈环境的搭建。我们最终实现的效果是前端Vue项目打包后由Nginx提供服务后端Spring Boot应用运行在独立的容器中两者通过Docker网络通信整个系统可以通过docker-compose一键启停。2. 环境准备与工具选型2.1 基础环境配置在开始之前需要确保宿主机已经安装以下工具Docker 20.10社区版即可Docker Compose 1.29JDK 11用于本地开发调试Node.js 14用于前端开发注意生产环境建议使用Linux服务器本文以CentOS 7为例。Windows系统需要特别注意文件路径和换行符问题。我推荐使用以下版本组合经过实际生产验证$ docker --version Docker version 20.10.17, build 100c701 $ docker-compose --version docker-compose version 1.29.2, build 5becea4c2.2 项目结构设计合理的项目结构能大幅降低后期维护成本。我们的项目结构如下project-root/ ├── backend/ # Spring Boot项目 │ ├── src/ │ ├── Dockerfile │ └── pom.xml ├── frontend/ # Vue项目 │ ├── public/ │ ├── src/ │ ├── Dockerfile │ └── package.json ├── nginx/ # Nginx配置 │ └── default.conf └── docker-compose.yml # 编排文件这种结构将前后端完全分离每个组件有自己的Dockerfile最终通过docker-compose统一管理。相比将前后端打包到一个容器中的方案这种设计更符合微服务理念也便于独立扩展。3. Spring Boot后端容器化3.1 Dockerfile编写后端Dockerfile有几个关键点需要注意# 使用多阶段构建减小镜像体积 FROM maven:3.8.6-jdk-11 AS build WORKDIR /app COPY pom.xml . # 先单独复制pom.xml并下载依赖利用Docker缓存 RUN mvn dependency:go-offline COPY src ./src RUN mvn package -DskipTests # 运行时阶段 FROM openjdk:11-jre-slim WORKDIR /app COPY --frombuild /app/target/*.jar app.jar # 时区设置 RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime # 健康检查 HEALTHCHECK --interval30s --timeout3s \ CMD curl -f http://localhost:8080/actuator/health || exit 1 EXPOSE 8080 ENTRYPOINT [java, -jar, app.jar]这个Dockerfile有几个优化点使用多阶段构建最终镜像只包含JRE而非完整的JDK体积从300MB减少到100MB左右先单独复制pom.xml下载依赖利用Docker缓存机制加速后续构建添加健康检查方便容器编排系统监控服务状态设置时区避免容器内时间与宿主机不一致的问题3.2 常见问题解决在实际构建过程中可能会遇到以下问题问题1Maven构建缓慢解决方案可以在Dockerfile中添加阿里云镜像RUN sed -i s|https://repo.maven.apache.org|https://maven.aliyun.com/repository/public|g /usr/share/maven/conf/settings.xml问题2时区不正确虽然Dockerfile中设置了时区但某些基础镜像可能缺少时区数据。可以改用RUN apt-get update apt-get install -y tzdata问题3内存不足Spring Boot应用默认会占用较多内存可以在docker-compose中限制deploy: resources: limits: memory: 1024M4. Vue前端容器化4.1 前端Dockerfile优化前端项目的容器化有几个特殊考虑# 构建阶段 FROM node:16-alpine AS build WORKDIR /app COPY package*.json ./ RUN npm install --registryhttps://registry.npm.taobao.org COPY . . RUN npm run build # 生产阶段 FROM nginx:1.21-alpine COPY --frombuild /app/dist /usr/share/nginx/html COPY nginx/default.conf /etc/nginx/conf.d/default.conf EXPOSE 80关键优化点使用Alpine基础镜像大幅减小镜像体积设置国内npm镜像加速构建分离构建阶段和运行阶段最终镜像只包含静态文件和Nginx自定义Nginx配置解决前端路由问题4.2 Nginx关键配置前端项目通常需要特殊处理路由问题以下是nginx/default.conf的典型配置server { listen 80; server_name localhost; location / { root /usr/share/nginx/html; index index.html; try_files $uri $uri/ /index.html; } location /api { proxy_pass http://backend:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }这个配置实现了两个重要功能处理Vue Router的history模式通过try_files确保刷新页面不返回404将/api开头的请求代理到后端服务解决跨域问题5. Docker Compose编排5.1 完整编排文件docker-compose.yml将前后端服务整合version: 3.8 services: backend: build: ./backend container_name: app-backend restart: unless-stopped ports: - 8080:8080 environment: - SPRING_PROFILES_ACTIVEprod - TZAsia/Shanghai networks: - app-network frontend: build: ./frontend container_name: app-frontend restart: unless-stopped ports: - 80:80 depends_on: - backend networks: - app-network networks: app-network: driver: bridge5.2 编排技巧解析网络配置创建自定义网络app-network使容器间可以通过服务名通信如backend:8080依赖管理通过depends_on控制启动顺序但要注意这不能确保服务已完全就绪环境变量传递Spring Boot的profile配置和时区设置重启策略unless-stopped确保容器异常退出时自动重启重要提示生产环境应该添加资源限制和健康检查完整示例deploy: resources: limits: cpus: 0.5 memory: 512M restart_policy: condition: on-failure6. 部署与运维实践6.1 一键部署命令完整的部署流程只需要三个步骤# 1. 构建镜像 docker-compose build # 2. 启动服务 docker-compose up -d # 3. 查看日志 docker-compose logs -f6.2 生产环境优化建议镜像管理使用docker-compose pull获取最新镜像定期清理无用镜像docker image prune -a -f日志收集logging: driver: json-file options: max-size: 10m max-file: 3数据持久化 如果应用有文件上传功能需要挂载卷volumes: - ./uploads:/app/uploads健康检查 在docker-compose中扩展健康检查healthcheck: test: [CMD, curl, -f, http://localhost:8080/actuator/health] interval: 30s timeout: 10s retries: 36.3 性能监控方案建议部署以下监控组件cAdvisor容器资源监控docker run -d --namecadvisor \ -v /:/rootfs:ro \ -v /var/run:/var/run:ro \ -v /sys:/sys:ro \ -v /var/lib/docker/:/var/lib/docker:ro \ -p 8081:8080 \ google/cadvisorPortainer可视化容器管理docker run -d -p 9000:9000 \ -v /var/run/docker.sock:/var/run/docker.sock \ portainer/portainer7. 常见问题排查指南7.1 启动问题排查问题容器启动后立即退出排查步骤查看日志docker logs container_id检查端口冲突netstat -tulnp | grep 8080检查依赖服务是否就绪docker-compose logs backend问题前端无法访问后端API解决方案确保docker-compose中使用了自定义网络检查Nginx配置中的proxy_pass地址是否正确在容器内测试连通性docker exec -it frontend curl http://backend:8080/api/health7.2 性能问题排查问题应用响应缓慢排查命令# 查看容器资源使用 docker stats # 进入容器分析 docker exec -it backend bash top -H -p $(pgrep java)优化建议调整JVM参数-Xmx512m -Xms512m增加容器资源限制检查数据库连接池配置7.3 安全加固措施避免使用root用户运行容器USER 1000:1000定期更新基础镜像docker-compose build --no-cache --pull敏感信息管理env_file: - .env.production8. 进阶优化方案8.1 使用CI/CD自动化流程推荐GitLab CI示例配置stages: - build - deploy build_backend: stage: build script: - docker build -t backend-image ./backend deploy_prod: stage: deploy only: - master script: - scp docker-compose.yml userserver:/app - ssh userserver cd /app docker-compose pull docker-compose up -d8.2 镜像瘦身进阶技巧使用JLink定制JRERUN jlink --add-modules java.base,java.logging \ --strip-debug \ --no-man-pages \ --no-header-files \ --compress2 \ --output /opt/jre-minimal前端使用多阶段构建压缩RUN npm install -g compression-webpack-plugin \ npm run build -- --mode production8.3 灰度发布方案通过docker-compose实现蓝绿部署services: backend-v1: image: backend:1.0 networks: - app-network backend-v2: image: backend:2.0 networks: - app-network frontend: depends_on: - backend-v2切换流量只需更新frontend的depends_on并重启。9. 项目迁移与扩展9.1 传统项目迁移指南迁移已有项目到Docker的步骤分析现有依赖ldd /path/to/binary创建Dockerfile逐步添加依赖测试容器内功能完整性调整配置文件路径9.2 微服务扩展方案当需要扩展为微服务架构时每个服务独立Dockerfile使用docker-compose.override.yml管理不同环境添加API网关服务集成服务发现Consul/Eureka示例扩展结构project-root/ ├── auth-service/ ├── user-service/ ├── product-service/ ├── gateway/ └── docker-compose.yml9.3 数据库容器化建议生产环境数据库部署建议db: image: postgres:13-alpine volumes: - pg_data:/var/lib/postgresql/data environment: POSTGRES_PASSWORD_FILE: /run/secrets/db_password secrets: - db_password secrets: db_password: file: ./secrets/db_password.txt关键注意事项必须配置数据卷持久化使用secrets管理敏感信息建议单独部署数据库容器定期备份卷数据