Docker Compose一键部署Java+MySQL容器环境教程

本文详解了使用 Docker Compose 一键部署 Java + MySQL 容器环境时最常踩的四大“坑”：MySQL root 密码因 volume 残留而失效、Java 应用误用 localhost 导致连接失败、Java 启动过早引发数据库连接拒绝、以及 build context 和 Dockerfile 路径配置错误导致镜像构建失败；通过清晰的问题现象、根本原因剖析和可立即落地的解决方案（如 docker-compose down -v 清理数据、用服务名替代 localhost、引入连接重试机制、规范构建路径），帮你避开新手高频陷阱，真正实现稳定、可靠、开箱即用的容器化开发环境。

docker-compose.yml 里 MySQL 的 root 密码不生效？

常见现象是 Java 应用连不上 MySQL，报 Access denied for user 'root'@'172.x.x.x'，但你明明在 environment 里写了 MYSQL_ROOT_PASSWORD。

根本原因是：MySQL 容器首次启动时才会读取 MYSQL_ROOT_PASSWORD 初始化 root 密码；如果容器已存在、卷（volume）没清空，它会跳过初始化，直接复用旧数据目录里的密码（可能是空或随机生成的）。

• 每次改密码前先删掉旧数据：docker-compose down -v（-v 是关键，否则 volume 残留）
• 确认 mysql 服务块里没有挂载外部路径到 /var/lib/mysql，否则 volume 会被绕过，但数据仍残留
• 如果要用固定数据目录，改密码得进容器执行：docker exec -it myapp-mysql mysql -uroot -p -e "ALTER USER 'root'@'%' IDENTIFIED BY 'newpass';"

Java 应用怎么连上 MySQL 容器？别写 localhost

本地开发时习惯写 jdbc:mysql://localhost:3306/mydb，但在 Docker Compose 网络里，localhost 指的是 Java 容器自己，不是 MySQL 容器。

Docker Compose 默认为每个服务创建 DNS 记录，服务名就是主机名。假设你的 MySQL 服务叫 mysql，Java 容器里就该用 jdbc:mysql://mysql:3306/mydb。

• 检查 docker-compose.yml 中 MySQL 服务的 container_name 或服务名（如 mysql:），这就是 Java 里要填的 host
• 端口必须写容器内端口（3306），不是 ports 映射的宿主机端口（如 "3307:3306" 对 Java 容器无效）
• 加 ?useSSL=false&serverTimezone=UTC 避免连接后时区/SSL 报错，尤其 MySQL 8+ 默认强制 SSL

Java 容器启动太快，MySQL 还没 ready 就报 Connection refused

现象是 Java 日志一上来就抛 Communications link failure，然后整个应用崩溃退出。Docker Compose 默认并行启动所有服务，不等 MySQL 监听完 3306 就跑 Java。

不能靠 depends_on 解决——它只控制启动顺序，不检查端口就绪状态。

• Java 侧最稳做法：用带重试的数据库连接池（如 HikariCP 配 connection-timeout + initialization-fail-timeout）
• 简单粗暴法：Java 启动脚本里加等待逻辑，例如 while ! nc -z mysql 3306; do sleep 2; done && java -jar app.jar
• 更干净的做法是用 docker-compose.yml 的 healthcheck + 自定义 wait 脚本，但对单次部署来说，Java 内部重试更可控

build context 和 Dockerfile 路径写错，Java 镜像构建失败

错误信息常是 ERROR: failed to solve: failed to read dockerfile: open /var/lib/docker/tmp/buildkit-mount*/Dockerfile: no such file or directory，或者构建时找不到 target/*.jar。

核心问题在于 build.context 是相对 docker-compose.yml 的路径，而 Dockerfile 里的 COPY 是相对 build context 的路径。

• 确保 build.context 指向含 pom.xml 和 src/ 的根目录，不是子模块或 target 目录
• Dockerfile 里写 COPY target/myapp.jar app.jar 前，必须先 mvn clean package 生成 jar；建议在 CI 或本地构建时预打包，而不是在 Docker 构建阶段跑 Maven（太慢且易出错）
• 如果用多阶段构建，注意第一阶段 FROM maven:3.9-openjdk-17 的镜像是否匹配项目 JDK 版本，JDK 不一致会导致编译失败或运行时报 UnsupportedClassVersionError

网络、时区、启动时机、路径——这四个点卡住的人最多，尤其是第一次从本地直连切到容器网络时，localhost 那一下最容易忽略。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~