Docker Compose构建Spring Boot后端无法连接MySQL问题求助

核心问题本质 #

Docker Compose的镜像构建阶段是完全独立于容器运行环境的——此时MySQL容器还未创建启动，哪怕配置了同一网络，构建过程也无法访问Compose中定义的MySQL服务，这是导致构建失败的核心原因。

具体排查与修复步骤 #

1. 检查后端Dockerfile的构建逻辑 #

如果你的Dockerfile在构建阶段执行了需要连接数据库的操作（比如mvn clean package触发测试用例），直接修改构建命令跳过数据库依赖步骤：

• 将构建命令改为：RUN mvn clean package -DskipTests
• 更规范的做法是采用多阶段构建，把编译和运行分离，避免构建阶段引入数据库依赖：

# 构建阶段：仅编译代码，跳过测试
FROM maven:3.8.6-openjdk-17 AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src ./src
RUN mvn clean package -DskipTests

# 运行阶段：仅复制编译产物
FROM openjdk:17-jdk-slim
WORKDIR /app
COPY --from=builder /app/target/backend.jar .
CMD ["java", "-jar", "backend.jar"]

2. 修正application.properties的连接配置 #

如果构建阶段必须连接数据库（不推荐），绝对不能用Compose服务名（如mysql）作为数据库主机名——构建阶段不在Compose网络内。此时要么：

• 临时使用宿主机的MySQL服务（需暴露端口且宿主机已启动MySQL），但这破坏了容器化隔离性；
• 彻底移除构建阶段的数据库依赖操作，将初始化逻辑放到容器启动阶段。

3. 控制服务启动顺序（针对启动阶段连接失败） #

如果是后端容器启动后连不上MySQL，大概率是MySQL初始化未完成。通过Compose的健康检查机制让后端等待MySQL就绪：
在docker-compose.yaml中添加健康检查配置：

services:
  mysql:
    build: ./mysql
    environment:
      MYSQL_ROOT_PASSWORD: your_password
      MYSQL_DATABASE: your_db
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
      interval: 5s
      timeout: 5s
      retries: 5
  backend:
    build: ./backend
    depends_on:
      mysql:
        condition: service_healthy
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/your_db?useSSL=false&serverTimezone=UTC

同时在application.properties中添加连接重试配置：

spring.datasource.hikari.connection-timeout=30000
spring.datasource.hikari.connection-test-query=SELECT 1
spring.datasource.hikari.validation-timeout=5000

4. 手动分步骤构建（临时应急方案） #

如果必须在构建阶段依赖MySQL，可手动拆分操作：

# 先启动MySQL服务并等待初始化完成
docker compose up -d mysql
# 单独构建后端镜像（此时MySQL已在运行）
docker compose build backend
# 启动所有服务
docker compose up -d

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