JPA CriteriaBuilder布尔查询在HSQLDB与PostgreSQL中结果不一致问题

你遇到的问题是Hibernate 5.0.12版本在不同数据库方言下，对**基本类型boolean结合AttributeConverter和CriteriaBuilder.isTrue()**的处理逻辑不一致导致的：

• HSQLDB方言会正确应用转换器，将isTrue(booleanValue)转换为查询boolAsString='O'；
• PostgreSQL方言则因为基本类型boolean的默认值特性（默认false），错误地将查询条件反向解析为boolAsString='N'。

这是因为Hibernate 5.0.x版本对基本类型的属性转换器支持存在缺陷，当使用boolean而非包装类型Boolean时，查询阶段的转换逻辑会受数据库方言的布尔类型映射规则干扰，导致生成的SQL不符合预期。

1. 改用包装类型Boolean替换基本类型boolean #

修改实体类中的字段定义，将基本类型改为包装类型，避免默认值干扰转换器的查询逻辑：

@Deprecated
private String boolAsString;

@Column(name = "boolAsString", insertable = false, updatable = false)
@Convert(converter = BooleanStringONWithoutNullConverter.class)
private Boolean booleanValue; // 从boolean改为Boolean

2. 升级Hibernate版本到5.2及以上 #

Hibernate 5.0.x属于较旧的版本，后续的5.2+版本修复了大量关于AttributeConverter和Criteria查询的跨方言一致性问题，升级后能避免这类奇怪的SQL生成差异。

3. 手动构建等值查询替代isTrue #

如果暂时无法修改实体或升级依赖，可以直接基于数据库列的实际值构建查询，绕过isTrue的方言差异问题：

Root<Entity> root = criteriaQuery.from(Entity.class);
Predicate equal = criteriaBuilder.equal(root.get(Entity_.boolAsString), "O");

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