Docker环境下Spring Boot无法连接MySQL容器，报通信链路失败错误

1. 数据库连接URL的两处错误 #

• 端口错误：容器之间通信使用容器内部端口，而非宿主机映射的3366。MySQL容器内部默认端口是3306，所以连接URL应改为jdbc:mysql://mysqldb:3306/tinyurl_db
• 环境变量格式错误：docker-compose的environment字段中，使用-前缀定义变量时，格式应为KEY=VALUE，而非KEY:VALUE。正确写法如下：

  environment:
    - SPRING_DATASOURCE_URL=jdbc:mysql://mysqldb:3306/tinyurl_db
  

2. MySQL未就绪导致的连接失败 #

depends_on仅保证容器的启动顺序，不确保MySQL服务已完全初始化并可以接受连接。Spring Boot启动时，可能MySQL还在初始化阶段，从而触发通信失败。解决方式有两种：

• 添加启动等待脚本：在Spring Boot的Docker启动脚本中加入等待逻辑，比如使用wait-for-it.sh脚本，等待mysqldb:3306端口可用后再启动应用
• 配置容器健康检查：给MySQL容器添加健康检查规则，让docker-compose等待MySQL就绪后再启动Spring Boot：

  mysqldb:
    image: mysql
    ports:
      - "3366:3306"
    volumes:
      - mysql-data:/var/lib/mysql
    networks:
      - springboot-mysql-network
    environment:
      MYSQL_DATABASE: tinyurl_db
      MYSQL_ROOT_PASSWORD: root
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-proot"]
      interval: 5s
      timeout: 5s
      retries: 5
  

  同时修改app_backend的depends_on配置，依赖MySQL的健康状态：

  app_backend:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    networks:
      - springboot-mysql-network
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysqldb:3306/tinyurl_db
    depends_on:
      mysqldb:
        condition: service_healthy
      redis_cache:
        condition: service_started
  

3. 可选：补充MySQL连接参数 #

可以在连接URL中添加必要参数，避免时区、SSL等潜在问题：

jdbc:mysql://mysqldb:3306/tinyurl_db?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC

内容的提问来源于stack exchange，提问作者torn-margin