Spring Boot3+Hibernate6中String转Varbinary致PostgreSQL字段过长问题

问题原因 #

迁移后Hibernate6的类型映射逻辑发生变化，部分String字段被错误映射为二进制类型（Varbinary），插入时字符串被转成十六进制格式存储，导致实际存储长度翻倍（比如原字符串长度100，转十六进制后变成200），超出varchar字段的长度限制，触发value too long for type character varying错误。

解决方案 #

1. 强制实体类字段的数据库类型 #

在FareRule实体类的String字段上显式指定columnDefinition，明确映射为PostgreSQL的varchar类型：

@Entity
public class FareRule {
    // 根据实际字段名和长度调整
    @Column(name = "rule_content", columnDefinition = "varchar(255)", length = 255)
    private String ruleContent;
    
    // 其他字段、getter/setter
}

也可通过@Type(type = "string")注解强制指定Hibernate类型：

@Type(type = "string")
@Column(length = 255)
private String ruleContent;

2. 全局配置Hibernate字符串映射规则 #

在Spring配置文件中添加全局配置，强制Hibernate将String类型映射为VARCHAR：

application.properties

spring.jpa.properties.hibernate.type.preferred_string_jdbc_type=VARCHAR

application.yml

spring:
  jpa:
    properties:
      hibernate:
        type:
          preferred_string_jdbc_type: VARCHAR

3. 调整PostgreSQL JDBC驱动版本 #

Spring Boot3默认适配的驱动版本可能对PostgreSQL11存在兼容问题，可手动指定适配版本：

Maven pom.xml

<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.5.4</version> <!-- 适配PostgreSQL 11的稳定版本 -->
</dependency>

4. 排查自定义类型转换器/Type #

如果项目中存在自定义的Hibernate Type或JPA Converter，检查其逻辑是否在Hibernate6下错误地将String转换为二进制类型，调整转换器确保输出为字符串类型。

5. 开启SQL日志定位问题 #

开启Hibernate SQL日志，查看实际生成的插入语句，确认字段类型和插入值格式：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

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