MySQL root密码不生效因volume残留导致初始化跳过；Java应连服务名而非localhost；需等待MySQL就绪再启动Java；build context路径错误致镜像构建失败。
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。
立即学习“Java免费学习笔记（深入）”；
- 检查
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 那一下最容易忽略。
