Spring Boot 3.2.7（Java 17）无法自动创建MySQL表及列问题排查

我首次使用Java 17和Spring Boot 3.2.7开发应用，启动后Spring Boot始终无法在MySQL的signuplogin库中创建对应表和列。相关代码与配置如下：

1. User实体类 #

import java.time.LocalDateTime;
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import jakarta.persistence.Table;
import jakarta.persistence.Transient;
import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;

@Entity
@Table(name = "User")
@Setter
@Getter
@AllArgsConstructor
@NoArgsConstructor
public class User {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;

    private String name;
    private String email;
    private String password;

    @Transient
    private String confirmPassword;

    private String ipAddress;
    private LocalDateTime sessionStarted;
    private LocalDateTime sessionClosed;
}

2. application.properties配置 #

spring.application.name=signuplogin
spring.datasource.url=jdbc:mysql://localhost:3306/signuplogin
spring.datasource.username=root 
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.hibernate.ddl-auto=update
spring.jpa.database-platform=org.hibernate.dialect.MySQL8Dialect

3. UserRepository接口 #

import org.springframework.data.jpa.repository.JpaRepository;
import entity.User;
public interface UserRepository extends JpaRepository<User, Long>{

}

启动应用后的控制台截图：

我期望Spring Data JPA自动生成对应表和列，但未生效，请问问题出在哪里？

1. 实体类扫描范围问题 #

Spring Boot默认只会扫描启动类所在包及其子包下的实体类。如果你的User实体类放在entity包，而启动类在其他包（比如com.example.signuplogin），JPA会找不到该实体，自然不会建表。

解决：要么把实体类移到启动类的子包下，要么在启动类上添加@EntityScan指定扫描路径：

@SpringBootApplication
@EntityScan("entity") // 手动指定实体类所在包
public class SignuploginApplication {
    public static void main(String[] args) {
        SpringApplication.run(SignuploginApplication.class, args);
    }
}

2. MySQL库与权限问题 #

首先确认signuplogin数据库是否已手动创建——spring.jpa.hibernate.ddl-auto=update只会在已有数据库中建表，不会自动创建数据库。另外检查root用户是否拥有该数据库的读写权限，比如能否手动在库内建表。

解决：先登录MySQL手动创建数据库：

CREATE DATABASE signuplogin;

再验证root账号可正常连接并操作该库。

3. 开启Hibernate日志排查 #

当前控制台未输出Hibernate的DDL执行日志，无法确认建表逻辑是否触发。可在application.properties中添加日志配置，查看具体执行情况：

logging.level.org.hibernate.SQL=DEBUG
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE

启动后观察控制台是否有CREATE TABLE相关SQL语句：若没有，说明Hibernate未识别到实体；若有但报错，根据错误信息进一步排查（比如字段类型不兼容、关键字冲突）。

4. 表名关键字冲突问题 #

User是MySQL的保留关键字，Hibernate生成建表语句时可能因关键字问题执行失败。

解决：要么修改表名（比如改为users），要么在@Table注解中用反引号包裹表名：

@Table(name = "`User`")

5. 依赖检查 #

确认pom.xml（Maven）或build.gradle（Gradle）中已正确引入Spring Data JPA和MySQL驱动依赖，Spring Boot 3.2.7对应的依赖示例：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <scope>runtime</scope>
</dependency>

依赖缺失或版本不匹配会导致JPA功能异常。

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