从Hibernate 5升级至6.4后生成错误SQL语句的问题

针对升级后遇到的SQL转换错误问题，核心原因是Hibernate 6对自定义转换器的处理逻辑与Hibernate 5存在差异，尤其是SQL生成阶段的类型推断和转换逻辑。以下是几种可行的解决办法：

1. 修正自定义转换器的注解配置 #

确保SiNoConverter明确标注转换的目标类型与数据库列类型，让Hibernate清晰识别Java类型与数据库列的映射关系：

@Converter(autoApply = false)
public class SiNoConverter implements AttributeConverter<Boolean, String> {
    @Override
    public String convertToDatabaseColumn(Boolean attribute) {
        return Boolean.TRUE.equals(attribute) ? "S" : "N";
    }

    @Override
    public Boolean convertToEntityAttribute(String dbData) {
        return "S".equals(dbData);
    }
}

在实体类字段上显式指定转换器，并匹配数据库实际列类型：

@Entity
@Table(name = "MyTable")
public class MyTable {
    // 其他字段...
    @Column(name = "cancellato", columnDefinition = "CHAR(1)")
    @Convert(converter = SiNoConverter.class)
    private Boolean cancellato;
}

这里的columnDefinition必须与数据库列的实际类型一致，避免Hibernate推断错误类型。

2. 调整JPQL查询写法，规避隐式类型转换 #

如果JPQL中直接使用cancellato = false，Hibernate 6可能生成复杂CASE语句。可以尝试两种调整方式：

• 方式一：依赖参数绑定触发转换器
  保持JPQL写法不变，通过参数绑定传入Boolean类型值：

SELECT t FROM MyTable t WHERE t.cancellato = :isCancelled

代码中绑定参数时传入Boolean.FALSE，让转换器自动处理为数据库端的'N'。

• 方式二：显式调用数据库兼容逻辑
  若上述方式无效，可直接用数据库列的原生值编写查询（不推荐长期使用，仅作临时兼容）：

SELECT t FROM MyTable t WHERE function('CAST', t.cancellato AS CHAR(1)) = 'N'

3. 配置Hibernate类型映射，强制指定列类型 #

在application.properties（或application.yml）中添加Hibernate类型映射配置，让Boolean类型与CHAR(1)列的转换逻辑更简洁：

spring.jpa.properties.hibernate.type.preferred_char_boolean_type=char
spring.jpa.properties.hibernate.type.char.boolean.to_string=true

该配置会让Hibernate生成类似Hibernate 5的简洁SQL，避免复杂CASE语句。

4. 检查转换器自动应用逻辑 #

如果你的转换器设置了autoApply = true，可能与Hibernate 6内置的类型转换逻辑冲突。建议改为显式在字段上标注@Convert注解，而非依赖自动应用。

验证步骤 #

修改配置后，开启Hibernate的SQL日志，确认生成的SQL是否回到cancellato = 'N'的形式，同时测试查询是否不再抛出转换错误。

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