Spring Boot 3+MySQL 8 Docker部署时JDBC连接异常求助

核心问题分析 #

从错误栈可知，Spring Boot应用启动时无法建立JDBC连接到MySQL数据库，根源在于以下几点：

• 数据库未就绪就发起连接：depends_on仅保证容器启动顺序，不会等待MySQL完成初始化
• 环境变量配置不全：Docker Compose中仅覆盖了数据库URL，未指定用户名/密码，且URL存在多余空格
• 容器内数据库地址错误：本地配置用localhost，但容器内需指向Docker Compose服务名mysqldb
• 镜像构建冗余：当前Dockerfile直接使用构建环境镜像运行，未采用轻量运行时镜像

修复方案 #

1. 完善Docker Compose配置 #

添加MySQL健康检查，确保Spring Boot仅在数据库就绪后启动；补全认证环境变量，修正URL格式：

version: "3.7"
services:
  api_service:
    build: .
    restart: on-failure
    ports:
      - 8080:8080
    networks:
      - springapimysql-net
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysqldb:3306/basics?allowPublicKeyRetrieval=true&useSSL=false
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=root
    depends_on:
      mysqldb:
        condition: service_healthy
    volumes:
      - ./m2:/root/.m2  # 修正Maven缓存目录，避免与MySQL数据目录冲突

  mysqldb:
    image: "mysql:8.0"
    restart: always
    ports:
      - 3306:3306
    networks:
      - springapimysql-net
    environment:
      MYSQL_DATABASE: basics
      MYSQL_PASSWORD: root
      MYSQL_ROOT_PASSWORD: root
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-proot"]
      interval: 5s
      timeout: 5s
      retries: 10
networks:
  springapimysql-net:

2. 优化application.properties #

保留本地开发配置，同时支持容器环境变量覆盖：

# 本地开发用localhost，容器环境会被Docker Compose变量覆盖
spring.datasource.url=jdbc:mysql://localhost:3306/basics?allowPublicKeyRetrieval=true&useSSL=false
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect
spring.jpa.hibernate.ddl-auto=update
# 添加连接重试机制，增强容错
spring.datasource.hikari.connection-timeout=20000
spring.datasource.hikari.maximum-pool-size=5
spring.jpa.open-in-view=false

3. 优化Dockerfile（多阶段构建减小镜像体积） #

用Maven构建后，将jar包复制到轻量OpenJRE镜像：

# 构建阶段
FROM maven:3.8.3-openjdk-17 AS build
WORKDIR /home/app
COPY src ./src
COPY pom.xml .
RUN mvn clean package -DskipTests

# 运行阶段
FROM openjdk:17-jre-slim
WORKDIR /app
COPY --from=build /home/app/target/spring_rest_docker.jar .
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "spring_rest_docker.jar"]

4. 更新pom.xml依赖（适配Spring Boot 3） #

替换为官方推荐的MySQL驱动：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.0</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>basic</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>basic</name>
    <description>Demo project for Spring Boot</description>
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        
        <!-- 适配Spring Boot 3的MySQL驱动 -->
        <dependency>
            <groupId>com.mysql</groupId>
            <artifactId>mysql-connector-j</artifactId>
            <scope>runtime</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
        <finalName>spring_rest_docker</finalName>
    </build>

</project>

验证步骤 #

1. 清理旧容器与数据卷：docker-compose down -v
2. 重新构建并启动：docker-compose up --build
3. 查看应用日志确认连接成功：docker-compose logs api_service

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