SpringBoot配置Hibernate Envers自定义枚举类型遇问题

我之前也踩过一模一样的坑！当用Hibernate Envers审计带有PostgreSQL自定义枚举类型的实体时，Envers经常会默认用普通字符串类型生成审计表的字段，导致和主表的枚举列不兼容，出现插入失败或者类型不匹配的错误。下面是我整理的靠谱解决步骤：

1. 完善自定义枚举类型的实现 #

你的PostgreSqlEnumType得正确处理PostgreSQL的枚举绑定，因为JDBC对PostgreSQL枚举的支持需要特殊逻辑。你可以参考这个标准实现：

import org.hibernate.HibernateException;
import org.hibernate.engine.spi.SharedSessionContractImplementor;
import org.hibernate.type.EnumType;
import java.sql.PreparedStatement;
import java.sql.SQLException;
import java.sql.Types;

public class PostgreSqlEnumType extends EnumType {
    @Override
    public void nullSafeSet(PreparedStatement st, Object value, int index, SharedSessionContractImplementor session) throws HibernateException, SQLException {
        if (value == null) {
            st.setNull(index, Types.OTHER);
        } else {
            // 用Types.OTHER绑定枚举字符串，适配PostgreSQL的枚举类型
            st.setObject(index, value.toString(), Types.OTHER);
        }
    }
}

2. 全局注册自定义类型，让Envers能识别 #

只在实体类上加@TypeDef有时候Envers不会继承这个配置，最好在package-info.java里全局注册，这样所有实体（包括Envers自动生成的审计实体）都能识别这个类型：

@TypeDefs({
    @TypeDef(name = "pgsql_enum", typeClass = PostgreSqlEnumType.class)
})
package com.yourproject.models; // 替换成你的实体所在包

import org.hibernate.annotations.TypeDef;
import org.hibernate.annotations.TypeDefs;

3. 确保枚举定义完全匹配 #

• 数据库里的枚举类型要和Java枚举的名称、值完全对应，比如数据库创建语句：

CREATE TYPE vehicle_types AS ENUM ('CAR', 'MOTORCYCLE', 'TRUCK');

• Java枚举类：

public enum VehicleTypes {
    CAR, MOTORCYCLE, TRUCK
}

注意大小写，PostgreSQL默认大小写不敏感，但保持一致能避免很多意外问题。

4. 配置正确的PostgreSQL方言 #

在application.properties或application.yml里指定合适的方言，新版本的方言对枚举支持更完善：

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

5. 验证审计表结构 #

启动应用后，检查生成的审计表（比如audit_cars）的vehicle_type列类型是不是你定义的vehicle_types枚举类型，而不是varchar。如果自动生成的不对，可以手动修改表结构，或者把spring.jpa.hibernate.ddl-auto设为update让Hibernate自动修正。

最后再确认你的实体注解没问题：

@Entity(name = "cars")
@Audited
// 已经全局注册TypeDef的话，这里可以不用重复写
// @TypeDef(name = "pgsql_enum", typeClass = PostgreSqlEnumType.class)
public class Car {
    // ...其他字段
    @Enumerated(STRING)
    @Type(type = "pgsql_enum")
    private VehicleTypes vehicleType;
    // ...getter setter
}

这样调整后，Envers应该就能正确处理PostgreSQL枚举类型的审计了！

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