Docker Compose部署Spring+MySQL应用时出现数据库通信链路连接失败问题

API 探路者

2026-11-4

MySQL连接通信失败问题排查与修正方案

从你提供的compose配置看，phpmyadmin服务已通过PMA_HOST: db的配置指定了数据库主机名，说明compose默认创建的应用网络没有隔离问题，主机名解析、跨容器通信的基础能力是正常的，故障可以聚焦在三个核心方向排查：

1. 服务启动时序不匹配

你当前配置的depends_on: db逻辑仅能保证db容器的启动顺序靠前，完全不判断MySQL服务是否完成初始化、3306端口是否可以正常接收连接请求
MySQL5.7首次启动初始化空数据卷的过程通常需要20-30秒，web容器启动后几秒就会发起数据库连接请求，此时MySQL还未完成初始化，直接抛出通信链路失败的错误
修正方案：
- 临时验证方式：先单独执行docker-compose up db启动数据库服务，等日志中出现ready for connections的输出后，再单独启动web服务，验证能否正常连接
- 长期稳定方案：给db服务添加健康检查，给web服务配置基于健康状态的启动依赖：
  在db服务配置块中追加健康检查逻辑：
```
db:
  # 原有image、volumes、environment等配置保持不变
  healthcheck:
    test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-ppassword1234"]
    interval: 5s
    timeout: 5s
    retries: 10
```
  修改web服务的depends_on配置，等待db健康检查通过后再启动：
```
web:
  depends_on:
    db:
      condition: service_healthy
```
  该语法兼容你当前使用的compose 3.3版本。

你当前是将war包直接挂载到官方Tomcat镜像中运行，这种外置Tomcat部署传统war包的场景下，项目内部硬编码的数据库连接配置优先级远高于你在compose文件中定义的环境变量
很多新手误以为写了SPRING_DATASOURCE_URLSpring就会自动读取对应值，实际上如果war包没有做配置适配，硬编码在包内WEB-INF/classes/目录下配置文件的数据库地址是127.0.0.1:3306这类本地回环地址，web容器内部并没有运行本地MySQL，自然会连接失败
修正方案：
- 解压你挂载的./target/ffengine-webb.war，检查内部Spring配置文件中的数据库连接配置，将硬编码的地址修改为jdbc:mysql://db:3306/app1?autoReconnect=true&useSSL=false&serverTimezone=Asia/Shanghai
- 如果需要保留环境变量的动态配置能力，需要在war包的配置文件中显式引用环境变量占位，比如配置为spring.datasource.url=${SPRING_DATASOURCE_URL}，Spring才会读取你在compose中定义的环境变量值

你配置了持久化卷db_vol来存储MySQL数据，如果之前曾经运行过这套compose文件，卷中已经留存了旧的MySQL数据，后续不管你怎么调整compose里的MySQL用户、密码、初始化脚本配置，都不会重新执行数据库初始化流程
这类残留会引发用户不存在、密码不匹配、指定数据库不存在等问题，最终导致连接被拒绝
修正方案：
- 停止所有服务后，执行docker-compose down -v（必须追加-v参数，才会删除之前创建的db_vol数据卷）
- 重新启动整套服务，等待MySQL完成首次全量初始化后再做连接验证

先进入web容器手动测试网络连通性：执行docker exec -it <web容器ID> ping db，确认能正常解析db服务的IP后，再执行docker exec -it <web容器ID> mysql -h db -u user1234 -p user1234 app1
- 如果这条命令能正常连上数据库，说明跨容器网络完全正常，问题100%出在web应用自身的配置上
- 如果这条命令都无法连通，再回头检查MySQL的用户权限、网络绑定配置
注意MySQL5.7对应的JDBC连接需要显式指定serverTimezone参数，否则高版本JDBC驱动会直接拒绝连接。

内容的提问来源于stack exchange，提问作者Ionathan Ardelean