Spring Boot JPA/Hibernate Criteria Query非字符串JSON类型过滤报错解决

问题原因 #

• PostgreSQL原生json类型未定义等于（=）比较运算符，只有jsonb类型支持直接等值匹配，你遇到的42883错误就是数据库找不到对应类型的比较运算符导致的。
• 你当前代码每次循环调用query.where()会覆盖之前的条件，多个过滤参数时只会生效最后一个，属于隐藏逻辑错误。
• Hibernate默认不知道如何将JsonNode对象映射为PostgreSQL的JSON类型参数，生成SQL时参数会被识别为未知类型，进一步触发类型不匹配报错。

修复方案 #

方案1（推荐）：修改字段类型为jsonb #

PostgreSQL推荐使用jsonb类型存储JSON数据，支持等值查询、索引和丰富的JSON操作符，改完表结构后按以下步骤适配即可：

1. 实体类JSON字段添加类型注解：

@Type(type = "jsonb")
@Column(columnDefinition = "jsonb")
private JsonNode policy;

2. 调整查询逻辑，修复条件覆盖问题，处理不同参数类型：

public Long getCountForMyEntity(JsonNode filter) {
    CriteriaBuilder criteriaBuilder = sessionFactory.getCriteriaBuilder();
    CriteriaQuery<Long> query = criteriaBuilder.createQuery(Long.class);
    Root<MyEntity> root = query.from(MyEntity.class);
    query.select(criteriaBuilder.count(root));

    // 存储所有过滤条件，避免覆盖
    List<Predicate> predicates = new ArrayList<>();
    Iterator<Map.Entry<String, JsonNode>> filterFields = filter.fields();

    while(filterFields.hasNext()) {
        Map.Entry<String, JsonNode> field = filterFields.next();
        String fieldName = field.getKey();
        JsonNode fieldValue = field.getValue();
        
        if (fieldValue.getNodeType() == JsonNodeType.STRING) {
            predicates.add(criteriaBuilder.equal(root.get(fieldName), fieldValue.asText()));
        } else {
            // 非字符串类型直接传JsonNode，Hibernate会根据实体字段的@Type注解映射为jsonb类型
            predicates.add(criteriaBuilder.equal(root.get(fieldName), fieldValue));
        }
    }

    query.where(predicates.toArray(new Predicate[0]));
    return sessionFactory.getCurrentSession().createQuery(query).getSingleResult();
}

方案2：不改表结构，使用显式类型转换 #

如果不能修改表的json类型，可以将JSON字段强制转成text类型再做等值比较，注意这种方式无法用到JSON字段的索引，性能较差，仅需调整非字符串类型的过滤逻辑即可：

// 非字符串类型的比较逻辑，把字段转成text，参数转成标准JSON字符串
predicates.add(criteriaBuilder.equal(
    root.get(fieldName).as(String.class), 
    fieldValue.toString()
));

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