如何通过Specification判断Postgres jsonb数组是否包含指定值

问题分析 #

你在实体类中用JSONB字段存储List<Long>类型数据，希望通过JPA Specification判断该列表是否不包含指定loanId，但使用jsonb_array_elements_set的方式存在问题——该函数仅用于将JSONB数组展开为集合，未完成包含性判断，且直接使用会导致结果集展开重复，无法实现预期逻辑。

推荐解决方案（高效实现） #

PostgreSQL提供了原生的JSONB包含操作符@>，可以直接判断数组是否包含指定值，无需展开数组，性能更优。在Specification中可以通过cb.function构造该条件：

private static Specification<UserPromoConditionsSpecifications> byLoanIdNotIn(Long loanId){
    return loanId == null ? null : (root, query, cb) -> {
        // 构造JSONB包含判断：检查loanDataIds是否包含[loanId]
        Expression<Boolean> contains = cb.function(
            "@>", Boolean.class,
            root.get("loanDataIds"),
            cb.literal(String.format("[%d]", loanId))
        );
        // 返回"不包含"的逻辑
        return cb.not(contains);
    };
}

也可以使用PostgreSQL的jsonb_contains函数替代@>操作符，效果一致：

private static Specification<UserPromoConditionsSpecifications> byLoanIdNotIn(Long loanId){
    return loanId == null ? null : (root, query, cb) -> {
        Expression<Boolean> contains = cb.function(
            "jsonb_contains", Boolean.class,
            root.get("loanDataIds"),
            cb.literal(String.format("[%d]", loanId))
        );
        return cb.not(contains);
    };
}

备选方案（基于数组展开） #

如果一定要用jsonb_array_elements_set，需要结合子查询判断是否存在匹配元素，再取反实现“不包含”逻辑，但这种方式性能低于直接使用@>：

private static Specification<UserPromoConditionsSpecifications> byLoanIdNotIn(Long loanId){
    return loanId == null ? null : (root, query, cb) -> {
        Subquery<Long> subquery = query.subquery(Long.class);
        Root<UserPromoConditionsSpecifications> subRoot = subquery.from(UserPromoConditionsSpecifications.class);
        
        subquery.select(subRoot.get("id"))
                .where(
                    cb.equal(subRoot.get("id"), root.get("id")),
                    cb.equal(
                        cb.function("jsonb_array_elements_set", Long.class, subRoot.get("loanDataIds")),
                        loanId
                    )
                );
        
        // 不存在匹配元素即表示不包含
        return cb.not(cb.exists(subquery));
    };
}

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