如何在Hibernate 6.6中映射PostgreSQL bytea类型到String

问题分析 #

• 实体字段content为String类型，通过@ColumnTransformer实现写入加密（转bytea）、读取解密（转String），数据库列类型是bytea。
• 当jpa.hibernate.ddl-auto设为validate时，Hibernate默认认为String字段对应VARCHAR类型，与实际bytea列类型不匹配，触发校验异常。
• 添加@JdbcTypeCode(SqlTypes.BINARY)后，Schema校验通过，但读取时Hibernate将解密后的字符串当作二进制数组处理，导致类型转换错误。

解决方案 #

通过组合注解，让Hibernate同时识别数据库列类型为bytea，且读取结果映射为String：

import org.hibernate.type.SqlTypes;
import org.hibernate.type.descriptor.java.StringJavaType;
import jakarta.persistence.Column;
import jakarta.persistence.ColumnTransformer;
import org.hibernate.annotations.JavaType;
import org.hibernate.annotations.JdbcTypeCode;

// ...

@Column(columnDefinition = "bytea")
@ColumnTransformer(
    read = "pgp_sym_decrypt(content, 'secret')",
    write = "pgp_sym_encrypt(?, 'secret')"
)
@JdbcTypeCode(SqlTypes.BINARY) // 告诉Hibernate数据库列是bytea类型，通过Schema校验
@JavaType(StringJavaType.class) // 指定读取结果映射为String类型
private String content;

原理说明 #

• @JdbcTypeCode(SqlTypes.BINARY)：让Hibernate在Schema校验时，将该字段与数据库的bytea列匹配，避免校验错误。
• @JavaType(StringJavaType.class)：明确Hibernate将pgp_sym_decrypt返回的字符串结果映射到String字段，解决二进制转String的类型转换异常。
• @ColumnTransformer：在SQL层面完成加密解密逻辑，写入时将字符串加密为bytea存储，读取时将bytea解密为字符串返回。

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