Spring Boot定义的Java实体未在H2数据库生成表的问题排查

我用IntelliJ IDEA的Spring Boot Initializer创建项目，引入spring-web、Spring Data JPA、H2 SQL依赖。完成配置后H2控制台可正常运行且连接成功，但创建的Book实体未在数据库中生成对应表。执行步骤如下：

1. 创建项目并添加上述依赖，主应用类代码如下：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Demo5Application {

    public static void main(String[] args) {
        SpringApplication.run(Demo5Application.class, args);
    }

}

2. 创建名为entity的包用于存放实体类；
3. 在该包下创建Book实体类，代码如下：

package com.example.demo.entity;

import javax.persistence.*;

@Entity
public class Book {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Integer id;
    private String name;
    private String category;
    private String sector;
    private String type;

    public Integer getId() {
    return id;
}

public void setId(Integer id) {
    this.id = id;
}

public String getName() {
    return name;
}

public void setName(String name) {
    this.name = name;
}

public String getCategory() {
    return category;
}

public void setCategory(String category) {
    this.category = category;
}

public String getSector() {
    return sector;
}

public void setSector(String sector) {
    this.sector = sector;
}

public String getType() {
    return type;
}

public void setType(String type) {
    this.type = type;
  }
}

4. 为实体类添加Getter和Setter方法（如上所示）；
5. 为实体类添加@Entity、@Id、@GeneratedValue等注解；
6. 在application.properties中配置H2数据库信息：

spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.url=jdbc:h2:mem:sarita
spring.datasource.username=SA
spring.datasource.password=

spring.h2.console.enabled=true
spring.h2.console.path=/h2

spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=create  

运行应用后H2连接成功，但进入控制台后未看到预期生成的Book表，请问哪里出错了？

• 确认实体类被JPA扫描到
  主应用类Demo5Application在com.example.demo包，Book实体在子包com.example.demo.entity，虽然@SpringBootApplication默认扫描当前包及子包，但如果项目结构有变动，可手动在主类添加@EntityScan(basePackages = "com.example.demo.entity")，强制指定实体扫描路径。

• 检查H2连接URL是否一致
  启动H2控制台时，登录页面的JDBC URL必须和application.properties里的jdbc:h2:mem:sarita完全一致。内存数据库是会话级的，URL不匹配会连接到全新的空数据库，自然看不到生成的表。

• 验证JPA配置有效性
  启动项目后，查看控制台日志（因为开了spring.jpa.show-sql=true），搜索是否有create table book开头的SQL语句。如果没有，说明实体未被识别；如果有，那就是连接的数据库不对。另外确保spring.jpa.hibernate.ddl-auto=create没有拼写错误，比如写成create-drop或none都会导致表不生成。

• 适配Spring Boot版本的注解包
  如果你的Spring Boot版本是3.x，JPA注解已经从javax.persistence.*迁移到jakarta.persistence.*。把Book实体里的注解替换成：

  import jakarta.persistence.Entity;
  import jakarta.persistence.GeneratedValue;
  import jakarta.persistence.GenerationType;
  import jakarta.persistence.Id;
  

  旧的javax包注解在Spring Boot 3.x中不会被识别，导致无法生成表。

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