如何让Hibernate识别PostgreSQL原生BOOLEAN类型避免无效查询

我有一个常规JPA实体类UserAccount，包含布尔类型字段isActive：

@Entity("UserAccount")
public class UserAccount {

   ...

   @Column(name = "isActive")
   private boolean isActive = false;

   ...
  
}

该实体对应PostgreSQL 15中的UserAccount表，表中isActive字段类型为原生BOOLEAN（非整数）：

CREATE TABLE UserAccount(
   ...
   isActive BOOLEAN NOT NULL,
   ...
)

当使用JPA Criteria API进行查询时：

criteriaBuilder.isTrue(root.get("isActive"))

生成的SQL查询语句中条件被渲染为= 1：

SELECT ...
FROM UserAccount
WHERE isActive = 1

PostgreSQL拒绝该查询并报错：

PSQLException: ERROR: operator does not exist: boolean = integer
Hint: No operator matches the given name and argument types. You might need to add explicit type casts.

我的问题是：如何告知Hibernate，我在表中使用的是PostgreSQL原生BOOLEAN类型而非用数字编码布尔值？

可以通过以下几种方式让Hibernate正确适配PostgreSQL原生BOOLEAN类型：

1. 配置正确的PostgreSQL方言 #

Hibernate的方言负责处理数据库特定的类型映射，必须确保配置文件中指定了适配PostgreSQL 15的正确方言：

• Hibernate 6+版本：使用org.hibernate.dialect.PostgreSQLDialect（自动适配PostgreSQL 10+）
• Hibernate 5.x版本：使用org.hibernate.dialect.PostgreSQL10Dialect及以上版本的方言

在persistence.xml中配置示例：

<property name="hibernate.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/>

Spring Boot项目可在application.properties中配置：

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect

正确的方言会让Hibernate知晓PostgreSQL的BOOLEAN类型直接对应Java的boolean，生成isActive = true而非=1的SQL条件。

2. 显式指定字段的数据库类型 #

如果方言配置正确但问题依旧，可在实体类字段上通过@Column注解强制指定数据库类型：

@Column(name = "isActive", columnDefinition = "BOOLEAN", nullable = false)
private boolean isActive = false;

也可使用Hibernate专属的jdbcType属性：

@Column(name = "isActive", jdbcType = JdbcType.BOOLEAN)
private boolean isActive = false;

这会强制Hibernate按照原生BOOLEAN类型处理该字段，避免将布尔值转换为整数。

3. 规范Criteria API的写法 #

确保Criteria查询中没有手动进行类型转换，保持使用标准的布尔值判断写法：

// 两种正确写法任选其一
criteriaBuilder.isTrue(root.get("isActive"));
criteriaBuilder.equal(root.get("isActive"), Boolean.TRUE);

只要方言配置正确，这两种写法都会生成符合PostgreSQL要求的SQL条件。

内容的提问来源于stack exchange，提问作者Martin Häusler