将数据库TEXT类型改为ENUM后Hibernate实体保存报错求助

错误原因分析 #

你遇到的问题是因为Hibernate默认的@Enumerated(EnumType.STRING)注解并没有识别PostgreSQL的自定义ENUM类型，而是将枚举值按普通字符串（VARCHAR）处理，但数据库列实际是自定义ENUM类型，导致JDBC类型映射冲突，出现期望smallint（枚举的序数存储逻辑）但实际匹配到VARCHAR的错误提示。

解决方案 #

1. 确保枚举类与数据库ENUM值完全一致 #

先确认你的TypeEnum枚举值和数据库中type_enum的定义完全对应：

enum class TypeEnum {
    TYPE1, TYPE2, TYPE3
}

2. 配置Hibernate正确映射PostgreSQL自定义ENUM #

根据你的Hibernate版本选择对应的配置方式：

方式一：Hibernate 5.x 版本（需额外依赖）

首先引入hibernate-types依赖（以Maven为例）：

<dependency>
    <groupId>com.vladmihalcea</groupId>
    <artifactId>hibernate-types-52</artifactId>
    <version>2.19.0</version>
</dependency>

然后在实体类上添加类型定义，并指定列的类型：

import org.hibernate.annotations.Type
import org.hibernate.annotations.TypeDef
import javax.persistence.*

@TypeDef(
    name = "pgsql_enum",
    typeClass = org.hibernate.type.PostgresEnumType::class
)
@Entity
@Table(name = "table1")
class YourEntity {
    // 其他字段...
    
    @Column(name = "type", columnDefinition = "type_enum", nullable = false)
    @Type(type = "pgsql_enum")
    @Enumerated(EnumType.STRING)
    val type: TypeEnum
}

方式二：Hibernate 6.x 版本（无需额外依赖）

Hibernate 6.x原生支持PostgreSQL ENUM类型，直接使用@JdbcTypeCode注解：

import org.hibernate.type.SqlTypes
import javax.persistence.*

@Entity
@Table(name = "table1")
class YourEntity {
    // 其他字段...
    
    @Column(name = "type", columnDefinition = "type_enum", nullable = false)
    @Enumerated(EnumType.STRING)
    @JdbcTypeCode(SqlTypes.ENUM)
    val type: TypeEnum
}

3. 验证数据库列类型 #

执行以下SQL确认table1的type列确实是自定义ENUM类型：

SELECT column_name, data_type, udt_name 
FROM information_schema.columns 
WHERE table_name = 'table1' AND column_name = 'type';

查询结果中udt_name应为type_enum，说明迁移脚本执行正确。

4. 确认方言配置 #

在你的配置文件（如application.properties）中确保使用正确的PostgreSQL方言：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
# 若使用PostgreSQL 10+，可使用更具体的方言：
# spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQL10Dialect

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