DockerCompose连接Java与数据库配置指南

本文深入解析了 Docker Compose 环境下 Java 应用与 MySQL 数据库可靠集成的关键实践：强调 service 间必须通过服务名（如 `jdbc:mysql://mysql:3306/myapp`）通信而非 localhost 或硬编码 IP，揭示 `depends_on` 的局限性并提供健康检查+重试机制破解“容器已启但数据库未就绪”的经典连接失败难题；同时给出环境变量驱动的本地/容器双模数据库切换方案、轻量镜像选型建议及调试技巧，直击开发中网络配置、启动时序、资源冲突等真实痛点，助你避开 90% 的 Docker 数据库连接陷阱。

docker-compose.yml 里 service 之间怎么正确通信

Java 应用连不上数据库，90% 是因为容器网络没走对——不是 IP 写错了，而是压根没在同一个 Docker 网络里。Docker Compose 默认会为整个 docker-compose.yml 创建一个独立桥接网络，所有 service 都自动加入，但前提是它们必须定义在同一份文件里，且不能靠 network_mode: "host" 或 network_mode: "bridge" 手动绕开。

实操建议：

• Java 应用的数据库连接 URL 必须用 service 名当 host，比如 jdbc:mysql://mysql:3306/myapp，其中 mysql 是你在 docker-compose.yml 里给数据库服务起的 name，不是 localhost 也不是 127.0.0.1
• 不要在 Java 应用里硬编码 172.x.x.x 这类 Docker 分配的 IP，它每次 up 都可能变
• 如果用了 depends_on，只控制启动顺序，不保证数据库“已就绪”；得配合健康检查或启动脚本重试

MySQL 启动后 Java 应用仍报 Connection refused

这是最典型的“依赖启动了但没准备好”问题。depends_on 只等容器进程起来，而 MySQL 的 mysqld 进程可能还在初始化、加载插件、恢复数据，此时 TCP 端口尚未监听，Java 的 JDBC 就已经发起连接并失败了。

实操建议：

• 给 MySQL service 加上 healthcheck，例如用 mysqladmin ping -h localhost -u root --password=$MYSQL_ROOT_PASSWORD
• Java 应用侧别一上来就死连，加个简单重试逻辑（比如最多 30 秒内每 2 秒试一次），Spring Boot 可配 spring.datasource.hikari.connection-timeout 和启动时的 spring.sql.init.mode=always 配合延迟初始化
• 避免在 entrypoint 或 command 里用 sleep 10 这种固定等待——环境不同，耗时不稳定

Java 应用镜像里要不要装 MySQL 客户端工具

不需要。JDBC 驱动是纯 Java 实现，不依赖系统级 MySQL 客户端二进制。装了反而增大镜像体积、引入无关 CVE 风险。

实操建议：

• 基础镜像选 eclipse-temurin:17-jre-jammy 这类轻量 JRE 版本，别用 -jdk 或带 buildpacks 的大镜像
• 如果只是为了调试连库，用 docker compose exec java-app sh 进容器，再用 curl 或 telnet 测通不通（telnet mysql 3306），比装 mysql-client 更快更干净
• 真要执行 SQL 调试，直接 docker compose exec mysql mysql -uroot -p$MYSQL_ROOT_PASSWORD myapp

如何让本地开发时 Java 应用能同时对接容器库和本地库

靠环境变量切换最稳妥。Docker Compose 支持 ${DB_HOST} 这类变量替换，你可以本地跑 DB_HOST=localhost DB_PORT=3306 docker compose up，而 CI 环境保持默认 DB_HOST=mysql。

实操建议：

• 在 docker-compose.yml 的 Java service 下写：environment: - SPRING_DATASOURCE_URL=jdbc:mysql://${DB_HOST}:${DB_PORT}/myapp
• MySQL service 本身不暴露 ports 到宿主机（除非真要本地 IDE 连），否则容易和本机 MySQL 冲突；如需暴露，用 ports: ["3307:3306"] 错开
• 本地开发时若用 IDE 直接运行 Java 主类（非容器），确保 application.yml 里 spring.datasource.url 也读环境变量，而不是写死 mysql

真正麻烦的从来不是写几行 YAML，而是数据库 schema 初始化时机、Flyway/Liquibase 在容器里怎么触发、以及 JVM 参数和 MySQL 容器内存限制撞车导致 OOM —— 这些得看日志里是 Java 报错还是 MySQL 被 kill。

理论要掌握，实操不能落！以上关于《DockerCompose连接Java与数据库配置指南》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！