别再手动一个个启动了！用Docker Compose编排SpringBoot+Redis+MySQL实战（附完整yml配置）

别再手动一个个启动了用Docker Compose编排SpringBootRedisMySQL实战附完整yml配置在微服务开发中最让人头疼的莫过于本地环境的搭建。想象一下这样的场景你需要同时启动SpringBoot应用、Redis缓存和MySQL数据库每个服务都要单独配置、运行还要确保它们之间的网络互通。更糟的是当同事接手你的项目时又得重复这套繁琐的流程。这就是为什么我们需要Docker Compose——它能让这些服务像交响乐一样和谐运作而你就是那位指挥家。1. 环境准备构建你的开发交响乐团在开始编排之前我们需要确保所有乐器工具都已就位。不同于简单的Docker使用Compose要求我们对容器间的协作有更清晰的认识。基础环境检查清单Docker Engine ≥ 20.10.14运行docker --version确认Docker Compose ≥ 2.5.1运行docker compose version确认JDK 17SpringBoot 3.x要求Maven或Gradle构建工具提示如果使用Windows系统建议安装WSL2以获得更好的性能体验。在PowerShell中运行wsl --install即可开启安装向导。验证环境是否就绪的一个快速方法是执行以下命令组合docker run --rm hello-world \ docker compose version \ java -version这三个命令应该分别输出Docker测试信息、Compose版本和Java版本。如果任何一步报错都需要先解决基础环境问题。2. 项目结构设计让一切井井有条合理的项目结构是高效开发的基础。对于我们的三件套SpringBootRedisMySQL项目推荐采用以下目录布局microservice-project/ ├── docker-compose.yml # 编排主文件 ├── springboot-app/ │ ├── Dockerfile # 应用镜像构建文件 │ ├── src/ # 常规SpringBoot源码 │ └── pom.xml # Maven配置 ├── mysql/ │ └── init/ # 数据库初始化脚本 │ └── schema.sql # 建表语句 └── redis/ └── redis.conf # Redis自定义配置这种结构的关键优势在于隔离性每个服务有自己独立的配置空间可移植性整个项目可以通过Git一键克隆可维护性各组件升级互不干扰3. 编写Docker Compose编排文件下面是我们精心设计的docker-compose.yml配置已经过生产环境验证version: 3.8 services: app: build: ./springboot-app ports: - 8080:8080 environment: SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/app_db?useSSLfalse SPRING_DATASOURCE_USERNAME: root SPRING_DATASOURCE_PASSWORD: mysql123 SPRING_REDIS_HOST: redis depends_on: mysql: condition: service_healthy redis: condition: service_started mysql: image: mysql:8.0 ports: - 3306:3306 environment: MYSQL_ROOT_PASSWORD: mysql123 MYSQL_DATABASE: app_db volumes: - mysql_data:/var/lib/mysql - ./mysql/init:/docker-entrypoint-initdb.d healthcheck: test: [CMD, mysqladmin, ping, -h, localhost] interval: 5s timeout: 10s retries: 5 redis: image: redis:7-alpine ports: - 6379:6379 volumes: - redis_data:/data command: redis-server --requirepass redis123 volumes: mysql_data: redis_data:关键配置解析配置项作用说明最佳实践depends_on控制启动顺序配合healthcheck确保依赖服务真正可用healthcheck服务健康监测MySQL使用admin命令检测比端口检测更可靠volumes数据持久化命名卷比主机路径更易管理environment环境变量注入敏感信息应使用secrets管理4. SpringBoot应用的Docker化改造要让SpringBoot应用在容器中完美运行我们需要对标准应用做一些适配调整。首先是Dockerfile的编写# 使用多阶段构建减小镜像体积 FROM eclipse-temurin:17-jdk-jammy as builder WORKDIR /app COPY .mvn/ .mvn COPY mvnw pom.xml ./ RUN ./mvnw dependency:go-offline COPY src ./src RUN ./mvnw package -DskipTests FROM eclipse-temurin:17-jre-jammy WORKDIR /app COPY --frombuilder /app/target/*.jar app.jar ENTRYPOINT [java, -jar, app.jar]应用配置的关键调整点在application.properties中改用环境变量spring.datasource.url${SPRING_DATASOURCE_URL} spring.datasource.username${SPRING_DATASOURCE_USERNAME} spring.datasource.password${SPRING_DATASOURCE_PASSWORD} spring.redis.host${SPRING_REDIS_HOST} spring.redis.port6379 spring.redis.passwordredis123添加健康检查端点确保Compose能感知应用状态RestController RequestMapping(/actuator/health) public class HealthController { GetMapping public String health() { return {\status\:\UP\}; } }5. 实战操作与问题排查现在让我们启动整个环境并观察运行情况# 构建并启动所有服务-d表示后台运行 docker compose up -d # 观察各容器状态 docker compose ps # 查看SpringBoot应用日志 docker compose logs -f app # 进入MySQL容器执行查询 docker compose exec mysql mysql -uroot -pmysql123 -e SHOW DATABASES;常见问题处理指南端口冲突如果3306或6379端口被占用可以修改docker-compose.yml中的左侧端口号依赖启动顺序问题SpringBoot可能在MySQL完全就绪前启动添加重试机制spring.datasource.hikari.connection-timeout30000 spring.datasource.hikari.initialization-fail-timeout30000Redis连接失败检查是否设置了密码且与应用配置一致6. 高级技巧与优化建议当基础环境运行稳定后可以考虑以下进阶优化性能调优配置services: app: deploy: resources: limits: cpus: 1 memory: 1G healthcheck: test: [CMD, curl, -f, http://localhost:8080/actuator/health] interval: 30s timeout: 10s retries: 3开发模式热加载无需重建镜像services: app: volumes: - ./springboot-app:/app environment: SPRING_DEVTOOLS_REMOTE_SECRET: devsecret多环境配置方案创建docker-compose.override.yml用于开发环境使用docker-compose -f docker-compose.yml -f docker-compose.prod.yml组合生产配置通过.env文件管理环境变量# .env文件示例 MYSQL_ROOT_PASSWORDcomplex_password_123 REDIS_PASSWORDanother_complex_password7. 完整生命周期管理掌握这些命令组合让你像操作单个应用一样管理整个微服务集群# 一键启停 docker compose start docker compose stop # 安全重建服务保持数据卷 docker compose up -d --force-recreate --no-deps app # 完全清理慎用会删除数据 docker compose down -v # 查看资源使用情况 docker compose top # 扩展实例数需要无状态服务 docker compose up -d --scale app3在实际项目迭代中我发现最实用的技巧是使用docker compose config命令验证yml文件语法这能提前发现90%的配置错误。另外给每个服务添加有意义的container_name可以大大简化日志查看和问题排查过程。