docker compose中service间通信须使用service名作host（如jdbc:mysql://mysql:3306/myapp），确保同网络；mysql健康检查+java重试机制解决“启动但未就绪”问题；环境变量切换实现本地与容器数据库灵活对接。
docker-compose.yml 里 service 之间怎么正确通信
Java 应用连不上数据库，90% 是因为容器网络没走对——不是 IP 写错了，而是压根没在同一个 Docker 网络里。Docker Compose 默认会为整个 docker-compose.yml 创建一个独立桥接网络，所有 service 都自动加入，但前提是它们必须定义在同一份文件里，且不能靠 network_mode: "host" 或 network_mode: "bridge" 手动绕开。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 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 就已经发起连接并失败了。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 给 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 风险。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 基础镜像选
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。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 在
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。
