Spring Boot+MySQL+Docker容器化启动失败求助

核心问题梳理 #

从错误日志和配置来看，导致Bean创建失败的根源是数据库连接未正确建立，同时存在Docker配置与应用运行方式的冲突，具体问题如下：

1. Docker Compose与Dockerfile的运行逻辑冲突 #

你的Dockerfile已经将应用打包成可执行的app.jar，并通过ENTRYPOINT指定了运行命令，但在docker-compose.yml中又设置了command: mvn spring-boot:run——这会覆盖Dockerfile的ENTRYPOINT，而你的镜像基于openjdk:17-jdk-alpine，本身不包含Maven，因此这个命令会直接失败，导致应用无法启动。

2. MySQL容器启动就绪问题 #

depends_on: [db]仅能保证MySQL容器先于应用容器启动，但无法确保MySQL服务已经完全就绪（比如初始化完成、可以接受连接）。应用启动时如果尝试连接未就绪的数据库，会抛出连接异常，进而导致依赖数据库的Bean（如userService）创建失败。

3. 潜在的环境变量配置细节问题 #

虽然你在docker-compose中设置了数据库连接的环境变量，但需要确保变量值与MySQL容器的配置完全匹配，同时Spring Boot环境变量推荐使用下划线分隔的命名规范（兼容性更强）。

修正后的配置文件 #

1. 修正docker-compose.yml #

version: '3.9'
services:
  db:
    image: mysql:8.0.28
    command: mysqld --default-authentication-plugin=mysql_native_password
    restart: always
    environment:
      TZ: America/Sao_Paulo
      MYSQL_ROOT_PASSWORD: ***  # 替换为你的实际root密码
      MYSQL_USER: docker
      MYSQL_PASSWORD: admin123
      MYSQL_DATABASE: gameplay
      MYSQL_ROOT_HOST: '%'
      MYSQL_TCP_PORT: 3308
    ports:
      - 3308:3308
    expose:
      - 3308
    networks:
      - erudio-network
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p***"]  # 替换为你的root密码
      interval: 5s
      timeout: 5s
      retries: 10
  gameplay:
    image: iago010/gameplay
    restart: always
    build: .
    environment:
      TZ: America/Sao_Paulo
      SPRING_DATASOURCE_URL: jdbc:mysql://db:3308/gameplay?useTimezone=true&serverTimezone=UTC
      SPRING_DATASOURCE_USERNAME: root
      SPRING_DATASOURCE_PASSWORD: ***  # 替换为你的实际root密码
      SERVER_PORT: 80  # 覆盖application.yml中的90端口，与ports映射一致
    ports:
      - 80:80
    depends_on:
      db:
        condition: service_healthy  # 等待MySQL服务就绪后再启动应用
    networks:
      - erudio-network
networks:
  erudio-network:
    driver: bridge

2. 保持Dockerfile不变 #

你的Dockerfile配置正确，无需修改：

FROM openjdk:17-jdk-alpine
VOLUME /tmp
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} app.jar
RUN sh -c 'touch /app.jar'
ENTRYPOINT ["java","-jar","/app.jar"]

3. 优化application.yml（可选） #

可以保留默认配置，让环境变量覆盖，或者直接修改为适配Docker的默认值：

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/gameplay  # 本地开发用，Docker环境会被环境变量覆盖
    username: root
    password: admin  # 本地开发用，Docker环境会被环境变量覆盖
  jpa:
    hibernate:
      ddl-auto: update
    properties:
      hibernate:
        dialect: org.hibernate.dialect.MySQL8Dialect
    show-sql: false
server:
  port: 90  # Docker环境会被SERVER_PORT环境变量覆盖为80
security:
  jwt:
    token:
      secret-key: 53cr37
spring-doc:
  paths-to-match:
    - /**
  swagger-ui:
    use-root-path: true

执行步骤 #

1. 确保已经打包好Spring Boot应用的jar包到target目录：

   mvn clean package -DskipTests
   

2. 启动容器：

   docker compose up -d --build
   

3. 查看应用日志确认启动状态：

   docker compose logs -f gameplay
   

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