Quarkus升级Hibernate后array_position()类型不匹配问题求助

问题根源 #

Hibernate 6.6版本对Criteria API中数组/集合类型的参数处理逻辑进行了调整：当传递映射为PostgreSQL数组的Java List/数组字段的Path时，Hibernate不再自动将其解析为SQL数组类型，而是将其识别为普通Java对象类型，导致array_position函数接收到不符合要求的参数类型，触发报错。

解决方案 #

方案1：显式将Path转换为SQL数组类型 #

使用Hibernate扩展的HibernateCriteriaBuilder，通过asArray方法将Path显式转换为数组表达式，确保Hibernate生成正确的SQL数组参数，同时修正array_position的返回类型错误：

import org.hibernate.query.criteria.HibernateCriteriaBuilder;

public <T> Predicate createArrayContainsExpression(final CriteriaBuilder criteriaBuilder,
                                                   final Path<List<T>> arrayPath,
                                                   final Expression<T> element) {
    HibernateCriteriaBuilder hibernateCb = (HibernateCriteriaBuilder) criteriaBuilder;
    // 显式将Path转换为数组表达式
    Expression<Object[]> arrayExpr = hibernateCb.asArray(arrayPath);
    // array_position返回整数类型，需修正泛型类型
    return criteriaBuilder.isNotNull(hibernateCb.function(
        "array_position",
        Integer.class,
        arrayExpr,
        element
    ));
}

方案2：改用PostgreSQL原生数组包含操作符@> #

PostgreSQL支持直接用@>操作符判断数组是否包含元素，相比array_position更直观，且Hibernate对该操作符的支持更稳定：

import org.hibernate.query.criteria.HibernateCriteriaBuilder;

public <T> Predicate createArrayContainsExpression(final CriteriaBuilder criteriaBuilder,
                                                   final Path<List<T>> arrayPath,
                                                   final Expression<T> element) {
    HibernateCriteriaBuilder hibernateCb = (HibernateCriteriaBuilder) criteriaBuilder;
    // 使用PostgreSQL的@>操作符，生成数组包含判断的SQL
    Expression<Boolean> containsExpr = hibernateCb.function(
        "@>",
        Boolean.class,
        arrayPath,
        hibernateCb.array(element) // 将单个元素包装为数组
    );
    return criteriaBuilder.isTrue(containsExpr);
}

方案3：调整实体字段的类型映射注解 #

通过更明确的注解配置，让Hibernate正确识别数据库数组类型：

import org.hibernate.type.PostgresArrayType;

@Column(name = "demand_types", columnDefinition = "smallint[]")
@Type(PostgresArrayType.class)
@Convert(converter = DemandType.DemandTypeListConverter.class)
private List<DemandType> demandTypes;

这里通过columnDefinition明确指定数据库字段为smallint[]，同时用@Type(PostgresArrayType.class)指定Hibernate使用PostgreSQL专属的数组类型处理器。

额外注意事项 #

• 确保EnumListConverter的转换逻辑正确：将List<T>转换为Short[]后，要保证Hibernate能正确映射到PostgreSQL的smallint[]类型。
• 在Criteria查询中优先使用Hibernate扩展的HibernateCriteriaBuilder处理数据库特定逻辑，减少版本升级带来的兼容性问题。

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