如何从含Hibernate TypeDef的JPA实体生成PostgreSQL枚举的Liquibase变更日志？

算力阿峰

2026-8-12

解决JPA Buddy生成PostgreSQL枚举类型Liquibase变更日志的问题

我之前碰到过完全一样的问题，已经成功实现需求，具体步骤如下：

1. 修正实体类注解配置

首先调整实体和枚举类的注解，不要加@Enumerated(EnumType.STRING)——PostgreSQLEnumType会直接处理Java枚举到PostgreSQL枚举的映射，多余的@Enumerated会让Hibernate降级到字符串类型：

@Entity
@TypeDef(
        name = "pgsql_enum",
        typeClass = PostgreSQLEnumType.class
)
public class MyEntity {
    @Type(type = "pgsql_enum")
    private MyEnumType myEnum;
}

对应的枚举类保持常规定义即可：

public enum MyEnumType {
    ENUM1, ENUM2, ENUM3
}

2. 配置Hibernate方言与JPA Buddy设置

在项目配置文件（如application.properties或persistence.xml）中指定PostgreSQL方言，确保Hibernate能识别枚举类型：
```
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
```
打开JPA Buddy的生成设置，选择SQL方言为PostgreSQL，并启用「生成自定义类型」选项，让JPA Buddy能识别pgsql_enum对应的数据库类型。

3. 生成或手动补充Liquibase变更日志

执行JPA Buddy的「从JPA实体生成Liquibase变更日志」功能，此时表结构中my_enum字段的类型应该会被识别为my_enum_type。

如果JPA Buddy没有自动生成CREATE TYPE语句，手动在变更日志最前面添加枚举类型的创建脚本：

<changeSet id="create-my-enum-type" author="your-author">
    <sql>
        create type my_enum_type as enum ('ENUM1', 'ENUM2', 'ENUM3');
    </sql>
    <rollback>
        drop type my_enum_type;
    </rollback>
</changeSet>

注意枚举值要和Java枚举的名称完全一致。