Spring Boot+Docker环境下MySQL数据库初始化失效问题排查

1. 修正配置项格式（针对.properties文件） #

你当前使用的spring_jpa_hibernate_ddl-auto=create是环境变量风格的下划线分隔，若使用.properties配置文件，需改为标准的点分隔格式：

spring.jpa.hibernate.ddl-auto=create

虽然表已创建说明该配置可能生效，但统一格式可避免潜在的配置解析问题。

2. 确保Docker容器启动顺序（等待数据库就绪） #

Docker Compose默认仅保证容器启动顺序，不等待数据库服务完全就绪。MySQL容器启动后需要几秒完成初始化，此时Spring Boot提前启动会导致data.sql执行时数据库未就绪，最终数据插入静默失败。

在docker-compose.yml中为MySQL添加健康检查，并让应用容器依赖MySQL的健康状态：

services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: your_db_password
      MYSQL_DATABASE: your_db_name
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
      interval: 5s
      timeout: 5s
      retries: 5
  spring-app:
    build: .
    depends_on:
      mysql:
        condition: service_healthy
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/your_db_name?useSSL=false&serverTimezone=UTC
      SPRING_DATASOURCE_USERNAME: root
      SPRING_DATASOURCE_PASSWORD: your_db_password
      SPRING_SQL_INIT_MODE: always
      SPRING_JPA_DEFER_DATASOURCE_INITIALIZATION: true
      SPRING_JPA_HIBERNATE_DDL_AUTO: create

3. 开启SQL初始化日志排查细节 #

添加日志配置，查看data.sql的加载与执行过程：

logging.level.org.springframework.sql.init=DEBUG
logging.level.org.springframework.jdbc=DEBUG

启动后检查日志，确认是否出现以下关键信息：

• Loading SQL from classpath:data.sql：说明文件被成功识别
• Executing SQL script：说明脚本开始执行
  如果没有这些日志，检查文件路径、文件名是否正确（如是否大小写错误）；如果有执行日志但无数据，查看是否存在字段不匹配、主键冲突等静默错误。

4. 验证data.sql语法与表结构匹配 #

• 确认work_position表的字段与INSERT语句完全一致：比如主键类型是否为INT，第二个字段是否为VARCHAR且长度足够容纳插入的字符串
• 检查所有INSERT语句是否存在语法错误：如未转义的单引号（字符串含'需改为''）、语句末尾缺少分号

5. 测试数据库用户的INSERT权限 #

虽然表已创建说明用户拥有CREATE权限，但需确认是否具备INSERT权限。进入MySQL容器手动执行插入测试：

docker exec -it <你的mysql容器ID> mysql -u root -p
# 进入数据库后执行
USE your_db_name;
INSERT INTO `work_position` VALUES (1,'Android developer');

若手动插入失败，需调整数据库用户的权限配置。

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