容器化Spring Boot应用无法连接容器内MySQL数据库求助

问题描述 #

我在将自研应用转为Docker部署时遇到问题，希望通过Docker Compose启动应用，编写了对应Compose文件与应用配置。执行Maven打包后启动容器，Spring Boot应用抛出CommunicationsException通信链接失败错误，提示未收到服务器数据包。但注释Compose中的Spring Boot服务，单独启动MySQL容器后本地运行应用可正常连接，恳请协助解决。

相关文件内容 #

Docker Compose文件 #

version: '3.9'
services:
  mysql:
    container_name: dbcontainer
    image: mysql
    environment:
      MYSQL_DATABASE: 
      MYSQL_USER: amazing05
      MYSQL_PASSWORD: amazing05
      MYSQL_ROOT_PASSWORD: amazing05
    ports:
      - "3306:3306"
    volumes:
      - ./sql:/docker-entrypoint-initdb.d
    networks:
      - my_network
        
  springbootapplication:
    depends_on:
      - mysql
    build: .
    ports:
      - "8080:80"

    environment:
      MYSQL_CONTAINER: dbcontainer
      MYSQL_USER: amazing05
    networks:
      - my_network
    restart: on-failure
    
networks:
  my_network:
    driver: bridge 

Spring Boot应用配置文件 #

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql = true
spring.datasource.url=jdbc:mysql://${MYSQL_CONTAINER:localhost}:3306/mycontainerdb
spring.datasource.username=${MYSQL_USER:root}
spring.datasource.password=${MYSQL_USER:root}
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQLDialect

错误信息 #

springbootapplication-1  | com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure
springbootapplication-1  | 
springbootapplication-1  | The last packet sent successfully to the server was 0 milliseconds ago. The driver has not received any packets from the server.

问题排查与解决 #

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

depends_on仅保证容器启动顺序，不确保MySQL服务完全就绪（比如数据库初始化、权限配置完成）。Spring Boot启动时MySQL还没准备好，导致连接失败。

解决办法：

• 方法一：在Spring Boot容器启动前添加延迟，修改Compose的springbootapplication服务，增加启动命令延迟：

  springbootapplication:
    # 其他配置不变
    command: bash -c "sleep 15 && java -jar your-app.jar"
  

  （替换your-app.jar为实际的JAR包名称，或根据Dockerfile启动命令调整）
• 方法二：保留restart: on-failure配置，让容器自动重试连接，直到MySQL就绪。

2. MySQL环境变量缺失目标数据库名 #

Compose中MySQL的MYSQL_DATABASE字段为空，导致容器启动时未自动创建mycontainerdb数据库，Spring Boot连接时找不到对应库。

解决办法：
补全MySQL的MYSQL_DATABASE配置：

mysql:
  environment:
    MYSQL_DATABASE: mycontainerdb # 补上目标数据库名
    MYSQL_USER: amazing05
    MYSQL_PASSWORD: amazing05
    MYSQL_ROOT_PASSWORD: amazing05

3. 数据库密码配置错误 #

应用配置中spring.datasource.password=${MYSQL_USER:root}错误使用了MYSQL_USER变量，应对应Compose中的MYSQL_PASSWORD，同时Spring Boot容器环境变量缺少密码配置。

解决办法：

• 修改应用配置文件：

  spring.datasource.password=${MYSQL_PASSWORD:root}
  

• 在Compose的springbootapplication服务中添加密码环境变量：

  springbootapplication:
    environment:
      MYSQL_CONTAINER: dbcontainer
      MYSQL_USER: amazing05
      MYSQL_PASSWORD: amazing05 # 新增密码变量
  

4. MySQL版本兼容性问题 #

默认mysql镜像会拉取最新版，可能与项目中JDBC驱动版本不兼容（比如MySQL 8.0+需要特定驱动配置）。

解决办法：
指定MySQL镜像版本，避免版本差异：

mysql:
  image: mysql:8.0

修改后的完整文件示例 #

调整后的Docker Compose文件 #

version: '3.9'
services:
  mysql:
    container_name: dbcontainer
    image: mysql:8.0
    environment:
      MYSQL_DATABASE: mycontainerdb
      MYSQL_USER: amazing05
      MYSQL_PASSWORD: amazing05
      MYSQL_ROOT_PASSWORD: amazing05
    ports:
      - "3306:3306"
    volumes:
      - ./sql:/docker-entrypoint-initdb.d
    networks:
      - my_network
        
  springbootapplication:
    depends_on:
      - mysql
    build: .
    ports:
      - "8080:80"
    environment:
      MYSQL_CONTAINER: dbcontainer
      MYSQL_USER: amazing05
      MYSQL_PASSWORD: amazing05
    command: bash -c "sleep 15 && java -jar app.jar" # 替换为实际启动命令
    networks:
      - my_network
    restart: on-failure
    
networks:
  my_network:
    driver: bridge 

调整后的应用配置文件 #

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql = true
spring.datasource.url=jdbc:mysql://${MYSQL_CONTAINER:localhost}:3306/mycontainerdb?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC
spring.datasource.username=${MYSQL_USER:root}
spring.datasource.password=${MYSQL_PASSWORD:root}
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect # MySQL8.0+适配方言

内容的提问来源于stack exchange，提问作者Dylan Hayes