Spring Boot中JPA/Hibernate的Product实体无法在H2生成表问题

问题描述 #

在学习Spring Boot整合JPA和Hibernate时，遇到Product实体无法初始化生成H2数据库表的问题。已排查SQL保留关键字，对应的DDL语句在PostgreSQL CLI中可正常创建表，但在H2中执行报错。

Product实体代码 #

public class Product {

    @Id
    @GeneratedValue
    private Long id;

    private Long stripe_id;
    private String name;
    private String image_url;
    private String price;
    private String description;
    private String path_url;
    private Date created_on;

    @OneToMany(mappedBy = "product")
    private List<Content> contents;

    @Enumerated(EnumType.STRING)
    private PRODUCT_DIFFICULTY difficulty;

    @Enumerated(EnumType.STRING)
    private PRODUCT_TYPE type;

    // getters, setters, equals and hashCode 已实现
}

报错堆栈信息 #

org.hibernate.tool.schema.spi.CommandAcceptanceException: Error executing DDL "create table "product" ("made_on" date, "id" bigint not null, "stripe_id" bigint, "image_url" varchar(255), "name" varchar(255), "path_url" varchar(255), "price" varchar(255), "product_info" varchar(255), "difficulty" enum ('ADVANCED','BEGINNER','INTERMEDIATE'), "type" enum (), primary key ("id"))" via JDBC [Syntax error in SQL statement "create table ""product"" (""made_on"" date, ""id"" bigint not null, ""stripe_id"" bigint, ""image_url"" varchar(255), ""name"" varchar(255), ""path_url"" varchar(255), ""price"" varchar(255), ""product_info"" varchar(255), ""difficulty"" enum ('ADVANCED','BEGINNER','INTERMEDIATE'), ""type"" enum ([*]), primary key (""id""))"; expected "INTERSECTS (, NOT, EXISTS, UNIQUE, INTERSECTS";]
    at org.hibernate.tool.schema.internal.exec.GenerationTargetToDatabase.accept(GenerationTargetToDatabase.java:94) ~[hibernate-core-6.6.15.Final.jar:6.6.15.Final]
    at org.hibernate.tool.schema.internal.Helper.applySqlString(Helper.java:233) ~[hibernate-core-6.6.15.Final.jar:6.6.15.Final]
    at org.hibernate.tool.schema.internal.Helper.applySqlStrings(Helper.java:217) ~[hibernate-core-6.6.15.Final.jar:6.6.15.Final]
    at org.hibernate.tool.schema.internal.SchemaCreatorImpl.createTables(SchemaCreatorImpl.java:430) ~[hibernate-core-6.6.15.Final.jar:6.6.15.Final]
    at org.hibernate.tool.schema.internal.SchemaCreatorImpl.createSequencesTablesConstraints(SchemaCreatorImpl.java:346) ~[hibernate-core-6.6.15.Final.jar:6.6.15.Final]
    at org.hibernate.tool.schema.internal.SchemaCreatorImpl.createFromMetadata(SchemaCreatorImpl.java:241) ~[hibernate-core-6.6.15.Final.jar:6.6.15.Final]
    at org.hibernate.tool.schema.internal.SchemaCreatorImpl.performCreation(SchemaCreatorImpl.java:174) ~[hibernate-core-6.6.15.Final.jar:6.6.15.Final]
    at org.hibernate.tool.schema.internal.SchemaCreatorImpl.doCreation(SchemaCreatorImpl.java:144) ~[hibernate-core-6.6.15.Final.jar:6.6.15.Final]

application.properties配置 #

spring.mvc.view.prefix=/resources/templates/
spring.h2.console.path=/h2-console
spring.h2.console.settings.trace=false
spring.h2.console.settings.web-allow-others=false
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.H2Dialect
spring.jpa.properties.hibernate.globally_quoted_identifiers=true
spring.application.name=demo

问题原因分析 #

从报错的DDL语句可以看出两个关键异常点：

1. type字段对应的枚举定义为空：enum ()，H2数据库不允许创建没有枚举值的ENUM类型字段，这是直接触发语法错误的原因。
2. DDL中出现了实体中不存在的字段（made_on、product_info），可能是旧代码编译残留导致Hibernate读取了过时的元数据。

解决方法 #

1. 检查并完善PRODUCT_TYPE枚举类 #

确保PRODUCT_TYPE枚举有具体的常量定义，示例：

public enum PRODUCT_TYPE {
    COURSE,
    E_BOOK,
    VIDEO_TUTORIAL
}

Hibernate生成DDL时会自动提取枚举常量，避免生成空的ENUM定义。

2. 清理编译残留并重新构建 #

删除项目的编译输出目录（如Maven的target或Gradle的build文件夹），执行mvn clean install（Maven）或gradle clean build（Gradle）重新编译，确保Hibernate读取最新的实体元数据。

3. 修改枚举字段的数据库类型映射（兼容方案） #

如果H2的ENUM类型兼容性问题仍存在，可以强制将枚举字段映射为VARCHAR类型，避免生成ENUM类型的DDL：

@Column(columnDefinition = "VARCHAR(255)")
@Enumerated(EnumType.STRING)
private PRODUCT_TYPE type;

4. 调整全局引号配置 #

暂时关闭spring.jpa.properties.hibernate.globally_quoted_identifiers=true，H2对带引号的标识符处理逻辑与PostgreSQL存在差异，关闭后可能解决语法解析问题。

内容的提问来源于stack exchange，提问作者Tyler Del Rosario