1. 为什么需要Docker Compose部署Spring Boot应用Spring Boot作为Java生态中最流行的应用开发框架其轻量级、开箱即用的特性深受开发者喜爱。但在实际生产环境中一个完整的应用往往需要数据库、缓存、消息队列等多个服务协同工作。传统部署方式需要手动配置每个服务既耗时又容易出错。Docker Compose的出现完美解决了这个问题。它允许我们通过一个YAML文件定义所有服务及其依赖关系实现一键启动完整环境。对于Spring Boot开发者而言这意味着开发环境与生产环境高度一致避免在我机器上能跑的问题快速搭建包含MySQL、Redis等组件的完整测试环境简化CI/CD流程实现自动化部署方便团队协作新成员只需一条命令即可启动项目2. 环境准备与基础配置2.1 安装Docker与Docker Compose在开始之前确保你的系统已安装以下工具Docker 20.10Docker Compose 2.0对于Linux系统推荐使用官方脚本安装# Docker安装 curl -fsSL https://get.docker.com | sh sudo systemctl enable --now docker # Docker Compose安装 sudo curl -L https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose注意生产环境建议使用固定版本而非latest标签避免意外升级导致兼容性问题2.2 Spring Boot应用Docker化首先需要为Spring Boot应用创建Dockerfile。以下是一个优化过的多阶段构建示例# 构建阶段 FROM eclipse-temurin:17-jdk-jammy as builder WORKDIR /app COPY . . RUN ./gradlew bootJar # 运行时阶段 FROM eclipse-temurin:17-jre-jammy WORKDIR /app COPY --frombuilder /app/build/libs/*.jar app.jar EXPOSE 8080 ENTRYPOINT [java, -jar, app.jar]关键优化点使用多阶段构建减小镜像体积从~500MB降至~150MB选择JRE基础镜像而非JDK使用非root用户运行增强安全性3. Docker Compose核心配置解析3.1 基础服务定义创建docker-compose.yml文件定义Spring Boot应用及其依赖服务version: 3.8 services: app: build: . ports: - 8080:8080 environment: - SPRING_PROFILES_ACTIVEdev - SPRING_DATASOURCE_URLjdbc:mysql://mysql:3306/demo depends_on: mysql: condition: service_healthy redis: condition: service_started mysql: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: rootpass MYSQL_DATABASE: demo MYSQL_USER: demo MYSQL_PASSWORD: demopass volumes: - mysql_data:/var/lib/mysql healthcheck: test: [CMD, mysqladmin, ping, -h, localhost] interval: 5s timeout: 10s retries: 5 redis: image: redis:7.0 ports: - 6379:6379 volumes: - redis_data:/data volumes: mysql_data: redis_data:3.2 高级配置技巧资源限制防止单个服务耗尽系统资源app: deploy: resources: limits: cpus: 1 memory: 512M日志管理避免日志文件占用过多磁盘app: logging: driver: json-file options: max-size: 10m max-file: 3网络隔离增强安全性networks: backend: driver: bridge internal: true4. Spring Boot应用的特殊配置4.1 配置文件优化在application.yml中配置环境变量占位符spring: datasource: url: ${SPRING_DATASOURCE_URL} username: ${MYSQL_USER} password: ${MYSQL_PASSWORD} redis: host: redis4.2 健康检查配置添加Spring Boot Actuator依赖implementation org.springframework.boot:spring-boot-starter-actuator然后在compose文件中添加健康检查app: healthcheck: test: [CMD, curl, -f, http://localhost:8080/actuator/health] interval: 30s timeout: 10s retries: 35. 实战部署流程5.1 开发环境部署构建并启动服务docker-compose up -d --build查看日志docker-compose logs -f app停止服务docker-compose down5.2 生产环境优化使用单独的网络networks: app_network: driver: bridge name: production_network添加重启策略app: restart: unless-stopped使用镜像而非源码构建app: image: your-registry/spring-app:${TAG:-latest} # 移除build配置6. 常见问题排查6.1 数据库连接问题症状应用启动时报数据库连接失败解决方案检查depends_on配置确保依赖顺序正确增加连接重试逻辑Spring Boot 2.6spring: datasource: hikari: connection-timeout: 30000 initialization-fail-timeout: 06.2 内存溢出问题症状容器频繁重启日志显示OOM解决方案限制容器内存app: deploy: resources: limits: memory: 1G调整JVM参数ENTRYPOINT [java, -Xmx512m, -Xms256m, -jar, app.jar]6.3 端口冲突问题症状服务启动失败提示端口已被占用解决方案检查主机端口使用情况ss -tulnp | grep 8080修改compose文件使用不同端口ports: - 8081:80807. 性能优化实践7.1 镜像构建优化使用.dockerignore文件排除不必要的文件**/*.gradle **/gradle **/build .git利用构建缓存# 先拷贝构建文件再拷贝源码 COPY build.gradle settings.gradle ./ RUN ./gradlew dependencies COPY src ./src7.2 启动速度优化使用Spring Boot 2.4的懒初始化spring: main: lazy-initialization: true启用Spring AOTSpring Boot 3.0./gradlew bootBuildImage --aot8. 安全最佳实践8.1 敏感信息管理使用Docker secretsmysql: environment: MYSQL_ROOT_PASSWORD_FILE: /run/secrets/db_root_password secrets: db_root_password: file: ./secrets/db_root_password.txt避免在compose文件中硬编码密码8.2 容器安全加固使用非root用户RUN adduser --system --no-create-home appuser USER appuser限制容器能力app: cap_drop: - ALL security_opt: - no-new-privileges:true9. 监控与日志收集9.1 Prometheus监控集成添加Micrometer依赖implementation io.micrometer:micrometer-registry-prometheus配置compose文件app: ports: - 8080:8080 - 9090:9090 # Prometheus metrics端口9.2 集中式日志管理添加ELK服务到compose文件services: elasticsearch: image: elasticsearch:8.6.2 environment: - discovery.typesingle-node volumes: - es_data:/usr/share/elasticsearch/data logstash: image: logstash:8.6.2 volumes: - ./logstash.conf:/usr/share/logstash/pipeline/logstash.conf kibana: image: kibana:8.6.2 ports: - 5601:5601 app: logging: driver: syslog options: syslog-address: tcp://logstash:500010. CI/CD集成示例10.1 GitHub Actions工作流name: Build and Deploy on: push: branches: [ main ] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkoutv3 - name: Login to Docker Hub uses: docker/login-actionv2 with: username: ${{ secrets.DOCKER_HUB_USERNAME }} password: ${{ secrets.DOCKER_HUB_TOKEN }} - name: Build and push uses: docker/build-push-actionv4 with: context: . push: true tags: yourusername/spring-app:latest - name: Deploy to production run: | scp docker-compose.prod.yml userserver:/app/ ssh userserver cd /app docker-compose -f docker-compose.prod.yml up -d10.2 多环境配置管理创建不同环境的compose文件docker-compose.yml # 基础配置 docker-compose.override.yml # 开发环境 docker-compose.prod.yml # 生产环境使用环境变量切换配置# 开发环境 docker-compose up -d # 生产环境 docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d在实际使用中发现合理组织compose文件结构比使用大量环境变量更易维护。特别是当服务数量增多时将不同环境的配置完全分离可以减少错误配置的风险。