升级Hibernate/Spring JPA后，嵌入式对象布尔查询异常

核心原因 #

这是Hibernate 6.x对JPA属性转换器（AttributeConverter）的处理逻辑变更导致的兼容问题，尤其是针对嵌入式对象（Embeddable）内的属性：

• Hibernate 5.x中，Spring Data JPA自动生成查询时，会正确调用转换器将Java布尔值转换为数据库存储的1/0；
• Hibernate 6.1.x版本中，对嵌入式属性的转换器应用存在逻辑错误，导致查询参数的转换方向颠倒：查询true时实际传入数据库的是0，查询false时传入的是1，直接造成结果反向。而findAll能正常获取数据，是因为从数据库读数据时的实体属性转换逻辑没有问题。

解决方案 #

1. 校验转换器配置与逻辑 #

确保你的BooleanConverter正确实现并配置：

@Converter(autoApply = true)
public class BooleanConverter implements AttributeConverter<Boolean, Integer> {
    // Java Boolean → 数据库Integer
    @Override
    public Integer convertToDatabaseColumn(Boolean attribute) {
        return attribute != null && attribute ? 1 : 0;
    }

    // 数据库Integer → Java Boolean
    @Override
    public Boolean convertToEntityAttribute(Integer dbData) {
        return dbData != null && dbData == 1;
    }
}

同时确认嵌入式对象的booleanValue属性上显式标注@Convert(converter = BooleanConverter.class)（即使autoApply=true，Hibernate 6对嵌入式属性的注解识别更严格）。

2. 手写JPQL查询规避自动生成问题 #

暂时绕过Spring Data JPA的自动查询生成，在Repository中用@Query手写查询：

@Repository
public interface MyEntityRepository extends JpaRepository<MyEntity, Long> {
    @Query("SELECT e FROM MyEntity e WHERE e.myEmbeddable.booleanValue = :value")
    List<MyEntity> findByBooleanValue(@Param("value") Boolean value);
}

手写JPQL会强制Hibernate正确触发转换器的参数转换逻辑。

3. 升级Hibernate到修复版本 #

该问题属于Hibernate 6.1.x的已知BUG，在6.2.x及以上版本中已修复。建议升级到Hibernate 6.2.0+，配合Spring JPA 3.1.0+使用。

4. 调整Hibernate布尔类型配置 #

添加以下配置，强制Hibernate将布尔类型按整数处理：

hibernate.type.preferred_boolean_jdbc_type=INTEGER

避免Hibernate默认将布尔值映射为数据库BOOLEAN类型，与你的1/0存储逻辑冲突。

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