Spring Boot+Docker部署时MySQL通信链路失败问题求助

核心原因 #

本地运行Spring Boot应用时，localhost指向宿主机，能正常访问Docker映射到宿主机的MySQL端口；但把应用部署到Docker容器后，容器内的localhost指的是容器自身，自然无法访问到另一个Docker容器里的MySQL，这就是Communications link failure的核心原因。

具体修复步骤 #

1. 修改JDBC URL配置 #

打开application.properties，把JDBC URL里的localhost替换成你docker-compose.yaml中MySQL服务的名称（比如你的compose里MySQL服务叫mysql，就直接写mysql），同时注意用MySQL容器内部的3306端口，不是宿主机映射的端口：

spring.datasource.url=jdbc:mysql://mysql:3306/你的数据库名?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
spring.datasource.username=你的用户名
spring.datasource.password=你的密码

2. 检查docker-compose的网络与依赖配置 #

确保Spring Boot服务和MySQL服务在同一Docker网络里（默认docker-compose会自动创建专属网络，只要两个服务在同一个compose文件里就会自动加入），同时添加健康检查保证MySQL完全初始化后再启动应用：

version: '3.8'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: 你的密码
      MYSQL_DATABASE: 你的数据库名
    ports:
      - "3306:3306"
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      timeout: 20s
      retries: 10

  spring-boot-app:
    build: .
    ports:
      - "8080:8080"
    depends_on:
      mysql:
        condition: service_healthy

depends_on加service_healthy是为了避免应用启动时MySQL还没初始化完成，导致连接失败。

3. 确认MySQL的绑定地址 #

默认MySQL镜像会绑定0.0.0.0，允许同网络内的其他容器访问。如果你自定义了MySQL配置，要确保my.cnf里的绑定地址不是127.0.0.1：

bind-address = 0.0.0.0

4. 排查错误日志细节 #

如果还是报错，重点看日志里的关键词：

• 若出现Connection refused：检查主机名、端口是否正确，MySQL容器是否正常启动
• 若出现Access denied：检查用户名密码、数据库权限是否配置正确

验证操作 #

修改完配置后，重新构建启动容器：

docker-compose down
docker-compose up --build

查看Spring Boot容器的日志，确认数据库连接成功。

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