Hibernate 6.x迁移报错：Character无法转为String，求解决方法

针对迁移至Hibernate 6.x后，VARCHAR2(1)列默认被解析为Character，导致与实体类String字段出现类型转换异常的问题，以下是几种解决办法：

1. 单个字段指定类型注解 #

直接在实体类目标字段上添加@Type注解，明确指定使用字符串类型映射：

import org.hibernate.type.StringType;

// ...

@Column(name = "TRANSACTION_CATEGORY_CODE", length = 1)
@Type(value = StringType.class)
private String transactionCategoryCode;

2. 显式定义列的SQL类型 #

在@Column注解中通过columnDefinition声明列的具体SQL类型，避免Hibernate自动推断为Character：

@Column(
    name = "TRANSACTION_CATEGORY_CODE",
    length = 1,
    columnDefinition = "VARCHAR2(1)"
)
private String transactionCategoryCode;

3. 全局配置（批量处理多列） #

如果项目中有大量长度为1的VARCHAR列需要映射为String，可通过全局配置修改Hibernate的默认行为：

• Spring Boot项目，在application.properties中添加：

spring.jpa.properties.hibernate.type.prefer_string_for_single_char_varchar=true

• 原生Hibernate配置，在hibernate.cfg.xml中添加：

<property name="hibernate.type.prefer_string_for_single_char_varchar">true</property>

原因说明 #

Hibernate 6.x优化了类型推断逻辑，默认将长度为1的VARCHAR列映射为Character类型，而旧版本默认映射为String，这是迁移后出现异常的核心原因。上述方法均可强制Hibernate将目标列解析为String类型。

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