Hibernate更新PostgreSQL枚举字段报错：列类型不匹配

我之前也碰到过一模一样的问题！这个错误的核心原因很明确：PostgreSQL的自定义枚举类型fulfillment_status和Hibernate默认传递的字符串类型不兼容——Hibernate把Java枚举当成普通字符串发给数据库，但数据库期望的是它自己定义的枚举类型，于是就抛出了类型不匹配的错误。下面是几个我亲测有效的解决办法，按推荐程度排序：

方法一：用Hibernate内置的PostgreSQL枚举类型（推荐） #

如果你用的是Hibernate 5.2及以上版本，直接用官方提供的PostgresEnumType就能搞定，不用自己写自定义类型：

1. 先确保你的Java枚举和数据库枚举的枚举值完全一致（大小写也要严格对应，PostgreSQL枚举是大小写敏感的！比如数据库里是'PENDING'，Java枚举就得是PENDING，名称一字不差）
2. 在实体类的枚举字段上添加这三个注解：

import org.hibernate.annotations.Type;
import javax.persistence.Enumerated;
import javax.persistence.Column;

// 你的枚举类
public enum FulfillmentStatus {
    PENDING, SHIPPED, DELIVERED
}

// 实体类里的字段
@Enumerated(EnumType.STRING)
@Type(type = "org.hibernate.type.PostgresEnumType")
@Column(name = "fulfillment_status", columnDefinition = "fulfillment_status")
private FulfillmentStatus fulfillmentStatus;

• @Enumerated(EnumType.STRING)：告诉Hibernate用枚举的名称（而不是序号）来映射
• @Type(...)：指定用Hibernate的PostgreSQL枚举类型处理器，让Hibernate知道要把Java枚举转换成PostgreSQL的自定义枚举类型
• columnDefinition：明确告诉Hibernate这个列的数据库类型是fulfillment_status，避免它生成错误的SQL语句

方法二：自定义UserType（兼容旧版Hibernate） #

如果你的Hibernate版本低于5.2，或者不想用内置类型，可以自己实现一个UserType来处理枚举转换：

1. 编写自定义类型类，重点实现nullSafeSet方法，把Java枚举转换成PostgreSQL能识别的枚举对象：

import org.hibernate.usertype.UserType;
import java.sql.PreparedStatement;
import java.sql.SQLException;
import org.hibernate.engine.spi.SharedSessionContractImplementor;

public class PostgresEnumUserType implements UserType {

    @Override
    public int[] sqlTypes() {
        return new int[]{java.sql.Types.OTHER};
    }

    @Override
    public Class<?> returnedClass() {
        return FulfillmentStatus.class; // 替换成你的枚举类
    }

    @Override
    public void nullSafeSet(PreparedStatement st, Object value, int index, SharedSessionContractImplementor session) throws SQLException {
        if (value == null) {
            st.setNull(index, java.sql.Types.OTHER);
        } else {
            // 把Java枚举转成字符串，然后以OTHER类型传给PostgreSQL，它会自动转换成对应的枚举
            st.setObject(index, value.toString(), java.sql.Types.OTHER);
        }
    }

    // 其他方法（比如equals、hashCode、deepCopy等）按默认实现即可，这里省略
}

2. 然后在实体字段上使用这个自定义类型：

@Enumerated(EnumType.STRING)
@Type(type = "com.yourpackage.PostgresEnumUserType") // 替换成你的类路径
@Column(name = "fulfillment_status", columnDefinition = "fulfillment_status")
private FulfillmentStatus fulfillmentStatus;

额外注意事项 #

• 一定要检查数据库枚举和Java枚举的枚举值是否完全一致，哪怕大小写错了都会触发这个错误
• 可以开启Hibernate的SQL日志，验证生成的SQL语句是否正确——正确的SQL应该是SET fulfillment_status = 'PENDING'::fulfillment_status（自动加上类型转换），而不是直接传字符串
• 如果用Spring Boot，确保你的Hibernate方言配置正确，比如在application.properties里：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQL15Dialect

（根据你的PostgreSQL版本选择对应的Dialect，比如PostgreSQL10Dialect、PostgreSQL15Dialect等）

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