docker-compose.yml 统一编排 JDK、MySQL、Redis 等服务,实现一键启停;需配置同网段通信、restart 策略、depends_on 与 healthcheck、端口映射,并支持热加载、初始化脚本及环境 profiles。

直接用 docker-compose.yml 定义整个环境,比一个个 docker run 拼凑高效得多。关键不是只跑一个 Java 应用,而是把 JDK、数据库、缓存、网关这些依赖服务全纳入统一编排,启动停用一键完成。
明确服务边界,按需组合组件
Java 项目通常不止一个容器。比如 Spring Boot + MySQL + Redis 的典型组合,每个服务都该独立定义:
-
应用服务:基于
openjdk:17-jdk-slim或amazoncorretto:17构建,挂载源码或打包好的 JAR,暴露 API 端口 -
MySQL:用
mysql:8.0镜像,通过volumes持久化数据目录,设置MYSQL_ROOT_PASSWORD和初始化 SQL 脚本 -
Redis:用
redis:7-alpine,简单配置即可,不需要持久化时可省略volumes - 如需前端联调,可加
nginx服务,反向代理到后端容器名(如http://app:8080)
写好 docker-compose.yml 的几个硬性细节
配置文件看似简单,但几处不注意就会导致连不上、启动失败或数据丢失:
- 所有服务放在同一个
default网络下(默认行为),这样容器间能用服务名互相访问,比如 Java 应用里 JDBC URL 写jdbc:mysql://mysql:3306/mydb - MySQL 和 Redis 的
restart: unless-stopped要加上,避免意外退出后服务中断 - Java 服务建议加
depends_on+healthcheck,例如等 MySQL 响应SELECT 1再启动应用,避免连接拒绝 - 端口映射别漏掉,如
- "8080:8080"对外暴露,但内部通信始终用容器名+默认端口(如mysql:3306)
本地开发友好型配置技巧
让容器真正服务于编码调试,而不是增加负担:
立即学习“Java免费学习笔记(深入)”;
- Java 服务用
build:+Dockerfile,但开发阶段推荐挂载./target/*.jar或整个src目录,配合热加载工具(如 Spring DevTools)实现代码改完自动生效 - 数据库初始化脚本放
./init.sql,通过volumes挂进 MySQL 容器的/docker-entrypoint-initdb.d/目录,首次启动自动执行 - 加一个
profiles字段区分 dev/test 环境,比如开发时启用 H2 内存库,测试时才启用真实 MySQL - 在
environment里设SPRING_PROFILES_ACTIVE=dev,让应用读取对应配置
启动、调试与日常维护
日常操作其实就三步,但每步都有要点:
- 启动:
docker-compose up -d后等几秒,用docker-compose logs -f app看 Java 服务日志,确认无连接异常 - 进入容器调试:
docker-compose exec app sh,里面可以直接运行java -jar或curl http://localhost:8080/actuator/health - 重置环境:
docker-compose down -v彻底清空 volumes,适合换分支或清理脏数据;docker-compose up --build强制重建镜像


















