如何在Hibernate 6中兼容Oracle与PostgreSQL查询空description字段

问题背景 #

使用Hibernate 6对接Oracle和PostgreSQL数据库，需要查询description（nvarchar(255)）字段不为空且非空字符串的条目，同时满足status=0、deleted≠false两个附加条件。

现有CriteriaBuilder代码在PostgreSQL中能正常返回结果，但Oracle中无数据返回——核心问题是Oracle会把空字符串自动存储为NULL，原代码里的cb.notEqual(root.get("description"), "")条件在Oracle中会过滤掉所有NULL值，和cb.isNotNull条件冲突，导致无结果；但去掉该条件后，PostgreSQL又会包含空字符串的条目，不符合需求。

解决方案 #

方法1：用Hibernate内置的isEmpty判断（推荐） #

Hibernate的CriteriaBuilder.isEmpty()方法会自动适配不同数据库的空值处理逻辑，无需手动区分数据库：

CriteriaBuilder cb = hibSession.getCriteriaBuilder();
CriteriaQuery<TestObjectDAO> criteria = cb.createQuery(TestObjectDAO.class);
Root<TestObjectDAO> root = criteria.from(TestObjectDAO.class);
criteria.select(root);

criteria.where(
        // 替换原有的两个description条件，取反isEmpty即可
        cb.not(cb.isEmpty(root.get("description"))),
        cb.equal(root.get("status"), 0),
        cb.notEqual(root.get("deleted"), false)
);
criteria.orderBy(cb.asc(root.get("name")));

Query<TestObjectDAO> query = hibSession.createQuery(criteria);
List<TestObjectDAO> objects = query.getResultList();

• 原理：cb.isEmpty()在PostgreSQL中会判断字符串是否为空串，在Oracle中会同时识别NULL和空串（因为Oracle空串等价于NULL），取反后就能统一筛选出既不是NULL也不是空字符串的条目。

方法2：根据数据库方言动态生成条件 #

如果需要更精细的控制，可以通过检测当前数据库方言，分别生成对应条件：

CriteriaBuilder cb = hibSession.getCriteriaBuilder();
CriteriaQuery<TestObjectDAO> criteria = cb.createQuery(TestObjectDAO.class);
Root<TestObjectDAO> root = criteria.from(TestObjectDAO.class);
criteria.select(root);

// 获取当前使用的数据库方言
Dialect dialect = hibSession.getSessionFactory().getJdbcServices().getDialect();
Predicate descriptionPredicate;

if (dialect instanceof OracleDialect) {
    // Oracle中空串已存为NULL，只需判断非NULL
    descriptionPredicate = cb.isNotNull(root.get("description"));
} else if (dialect instanceof PostgreSQLDialect) {
    // PostgreSQL中需同时判断非NULL和非空串
    descriptionPredicate = cb.and(
            cb.isNotNull(root.get("description")),
            cb.notEqual(root.get("description"), "")
    );
} else {
    // 其他数据库默认使用双条件判断
    descriptionPredicate = cb.and(
            cb.isNotNull(root.get("description")),
            cb.notEqual(root.get("description"), "")
    );
}

criteria.where(
        descriptionPredicate,
        cb.equal(root.get("status"), 0),
        cb.notEqual(root.get("deleted"), false)
);
criteria.orderBy(cb.asc(root.get("name")));

Query<TestObjectDAO> query = hibSession.createQuery(criteria);
List<TestObjectDAO> objects = query.getResultList();

方法3：统一数据存储逻辑（从源头解决） #

在实体类的description字段上添加注解，强制Hibernate将空字符串转换为NULL存储，让两个数据库的存储逻辑统一：

@Column(name = "description")
@ColumnTransformer(write = "CASE WHEN ? = '' THEN NULL ELSE ? END")
private String description;

• 这样写入数据时，空字符串会被自动转成NULL存储，查询时只需用cb.isNotNull(root.get("description"))即可，无需区分数据库。
• 注意：这种方式会改变原有数据的存储逻辑，需要确认是否符合业务需求。

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