Docker部署SpringBoot连接MySQL容器失败，求助排查通信链路问题

核心问题 #

SpringBoot容器与MySQL容器处于同一Docker网络，但SpringBoot启动后立即退出，抛出Communications link failure错误；本地直接运行Jar包或在IDE中启动应用时，却能正常连接该MySQL容器。

可能的原因及解决方案 #

1. MySQL容器未完成初始化，SpringBoot提前发起连接 #

Docker后台启动MySQL容器后，MySQL需要时间完成数据库初始化、用户创建等操作，而SpringBoot启动速度更快，此时发起连接会直接失败。

解决方法：

• 方法一：用Docker Compose编排（推荐）
  创建docker-compose.yml，通过健康检查确保SpringBoot在MySQL完全就绪后启动：

  version: '3.8'
  services:
    mysql:
      image: mysql:5.7
      container_name: mysql-springboot3
      networks:
        - spring-network
      environment:
        MYSQL_ROOT_PASSWORD: ThePassword
        MYSQL_USER: springuser
        MYSQL_PASSWORD: ThePassword
        MYSQL_DATABASE: db_example
      healthcheck:
        test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-pThePassword"]
        interval: 5s
        timeout: 5s
        retries: 5
    springboot-app:
      build: .
      container_name: rest-springboot3
      networks:
        - spring-network
      ports:
        - "8080:8080"
      depends_on:
        mysql:
          condition: service_healthy
  networks:
    spring-network:
      name: spring-network
  

  启动命令：docker-compose up -d

• 方法二：给SpringBoot添加启动延迟
  修改SpringBoot容器启动命令，增加等待时间：

  docker run -d -p 8080:8080 --name rest-springboot3 --network spring-network frarm2014/spring-boot3-rest:v1 sh -c "sleep 10 && java -jar your-app.jar"
  

  （替换your-app.jar为实际Jar包名称）

• 方法三：在SpringBoot配置中添加连接重试
  在application.properties中补充连接池重试参数：

  spring.datasource.hikari.connection-timeout=20000
  spring.datasource.hikari.maximum-pool-size=5
  spring.datasource.hikari.connection-test-query=SELECT 1
  spring.datasource.hikari.validation-timeout=3000
  spring.datasource.hikari.leak-detection-threshold=20000
  

2. Hibernate方言版本不匹配 #

你使用的是MySQL 5.7，但配置了MySQL8Dialect，存在版本兼容性问题。

解决方法：
修改application.properties中的方言配置：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL57Dialect

3. 验证MySQL容器状态 #

先确认MySQL容器是否完成初始化：

docker logs mysql-springboot3

查看日志中是否包含ready for connections字样，确认MySQL服务已就绪。

内容的提问来源于stack exchange，提问作者Frank Romero Morales