Spring Boot 3整合MySQL无法自动建表问题求助

一、核心配置校验 #

• 显式指定DDL操作模式
  Spring Boot 3中spring.jpa.hibernate.ddl-auto默认值为none（不执行任何DDL操作），必须显式配置为所需模式：

  spring:
    jpa:
      hibernate:
        ddl-auto: update # 可选值：create、create-drop、validate，按需选择
  

  注意：update会根据实体类更新表结构，不会删除已有数据；create会每次启动重建表，适合测试环境

• 适配Hibernate 6.x的数据库方言
  Spring Boot 3内置Hibernate 6.x，部分方言类路径变更，以MySQL为例：

  • 废弃Spring Boot 2常用的org.hibernate.dialect.MySQL5InnoDBDialect
  • 替换为适配MySQL 8+的org.hibernate.dialect.MySQL8Dialect
    配置示例：

  spring:
    jpa:
      properties:
        hibernate:
          dialect: org.hibernate.dialect.MySQL8Dialect
  

二、依赖兼容性检查 #

• 统一Spring Boot 3.x依赖版本
  确保POM中父依赖和starter依赖均为Spring Boot 3.x版本，避免混合Spring Boot 2依赖：

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.0</version> <!-- 使用最新稳定版 -->
    <relativePath/>
  </parent>
  
  <dependencies>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
      <groupId>com.mysql</groupId>
      <artifactId>mysql-connector-j</artifactId>
      <scope>runtime</scope>
    </dependency>
  </dependencies>
  

• 使用适配的数据库驱动
  Spring Boot 3默认使用com.mysql.cj.jdbc.Driver（替代旧的com.mysql.jdbc.Driver），无需手动指定版本，父依赖会管理兼容版本。

三、实体类注解修正 #

• 替换JPA注解包路径
  Spring Boot 3基于Jakarta EE，所有JPA注解需从jakarta.persistence导入，而非Spring Boot 2的javax.persistence：

  import jakarta.persistence.*;
  
  @Entity
  @Table(name = "user_info") // 表名与类名不一致时需显式指定
  public class User {
      @Id
      @GeneratedValue(strategy = GenerationType.IDENTITY)
      private Long id;
      private String username;
      private String email;
      // 省略getter、setter、构造方法
  }
  

• 确保实体类被Spring扫描
  实体类需放在启动类的同级或子包下，否则需通过@EntityScan指定扫描路径：

  @SpringBootApplication
  @EntityScan(basePackages = "com.yourproject.entity")
  public class ApiApplication {
      public static void main(String[] args) {
          SpringApplication.run(ApiApplication.class, args);
      }
  }
  

四、日志排查 #

• 开启Hibernate SQL日志
  配置日志级别查看DDL语句生成及执行情况：

  logging:
    level:
      org.hibernate.SQL: debug
      org.hibernate.type.descriptor.sql.BasicBinder: trace
  

  启动应用后，检查日志：
  • 无create table语句：检查ddl-auto配置和实体类扫描路径
  • 有语句但执行失败：根据日志中的错误信息排查（如数据库权限不足、字段类型不兼容）

五、数据库连接校验 #

确认数据库连接配置正确，应用可正常连接：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/your_db?useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true
    username: root
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver

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