Java JPA Criteria Builder：如何检查嵌套可空值

问题原因 #

你之前的写法无效，核心不是Java代码抛NullPointerException——Criteria API在构建查询时不会直接操作实体对象，所以不会在这一步触发空指针。真正的问题是：当你直接通过model.get("employer").get("employeeBenefits")访问关联属性时，JPA默认会生成内连接（INNER JOIN），这会自动过滤掉所有employer为null的Person记录，因为内连接要求关联表必须有匹配行。所以即使你写了isNull(model.get("employer"))，内连接已经把这类数据提前筛掉了，自然查不到结果。

解决方案：显式使用左连接（LEFT JOIN） #

要保留employer为null的记录，必须显式指定左连接，确保所有Person记录都被纳入查询范围，再结合OR条件筛选。

代码实现 #

public Specification<Person> hasNoEmployerOrNoBenefits() {
    return (root, query, criteriaBuilder) -> {
        // 显式左连接Person和Company，保留所有Person记录
        Join<Person, Company> employerJoin = root.join("employer", JoinType.LEFT);
        
        return criteriaBuilder.or(
            // 条件1：employer为null
            criteriaBuilder.isNull(root.get("employer")),
            // 条件2：雇主的employeeBenefits为"No benefits"
            criteriaBuilder.equal(employerJoin.get("employeeBenefits"), "No benefits")
        );
    };
}

为什么这样有效 #

左连接（LEFT JOIN）会返回所有Person记录，无论其employer是否存在：

• 当employer为null时，employerJoin对应的字段值都是null，此时第二个条件会返回false，但第一个条件isNull(root.get("employer"))为true，OR条件整体成立，这类记录会被保留；
• 当employer存在时，会正常判断其employeeBenefits是否等于"No benefits"，符合条件的记录也会被筛选出来。

替代方案：使用COALESCE处理null #

如果你不想显式写join，也可以用COALESCE函数将null值转换为一个默认值，再进行比较（不过推荐优先用左连接，逻辑更清晰）：

public Specification<Person> hasNoEmployerOrNoBenefits() {
    return (root, query, criteriaBuilder) -> {
        return criteriaBuilder.or(
            criteriaBuilder.isNull(root.get("employer")),
            criteriaBuilder.equal(
                // 将null的employeeBenefits转换为空字符串，避免比较null的问题
                criteriaBuilder.coalesce(root.get("employer").get("employeeBenefits"), ""),
                "No benefits"
            )
        );
    };
}

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