Hibernate从5.2.14升级至6.6.5后子查询触发SemanticException求助

错误原因 #

Hibernate 6.0+对JPQL/Criteria查询的类型检查大幅收紧，你的代码里子查询声明的返回类型是DemoAlias，但实际select(alias.get("personId"))返回的是Long类型（人员ID），类型不匹配触发了语义检查异常。Hibernate 5.x对这种类型不一致的情况容忍度更高，所以旧版本能正常运行。

修复方案 #

将子查询的返回类型修正为Long，和你要查询的personId类型保持一致：

protected List<DemoPerson> performSearch(EntityManager em, String searchText) {
    CriteriaBuilder cb = em.getCriteriaBuilder();
    CriteriaQuery<DemoPerson> cq = cb.createQuery(DemoPerson.class);
    Root<DemoPerson> root = cq.from(DemoPerson.class);

    // 处理姓名搜索：用cb.literal避免直接字符串拼接的风险
    String likePattern = "%" + searchText.toLowerCase() + "%";
    Predicate namePredicate = cb.like(
            cb.lower(root.get("fullName")),
            cb.literal(likePattern));

    // 修正子查询类型为Long（与personId类型一致）
    Subquery<Long> subquery = cq.subquery(Long.class);
    Root<DemoAlias> aliasRoot = subquery.from(DemoAlias.class);
    subquery.select(aliasRoot.get("personId"))
            .distinct(true)
            .where(cb.like(
                    cb.lower(aliasRoot.get("aliasText")),
                    cb.literal(likePattern)));

    // 类型匹配，异常解决
    Predicate aliasPredicate = root.get("id").in(subquery);
    Predicate finalPredicate = cb.or(namePredicate, aliasPredicate);

    cq.where(finalPredicate);
    TypedQuery<DemoPerson> query = em.createQuery(cq);
    query.setMaxResults(20);
    query.setFirstResult(0);

    return query.getResultList();
}

额外优化建议 #

• 避免SQL注入风险：更安全的方式是使用参数绑定替代字符串拼接，比如：

  // 定义参数占位符
  Predicate namePredicate = cb.like(cb.lower(root.get("fullName")), cb.concat(cb.concat("%", cb.parameter(String.class, "searchText")), "%"));
  // 后续设置参数
  query.setParameter("searchText", searchText.toLowerCase());
  

  这种方式能让数据库缓存查询计划，同时彻底避免注入风险。

• 利用实体关联简化查询：因为DemoPerson已经关联了aliases集合，可以用exists查询替代子查询，代码更简洁：

  Predicate aliasPredicate = cb.exists(
          cb.createQuery()
                  .select(cb.literal(1))
                  .from(root.join("aliases"))
                  .where(cb.like(cb.lower(root.join("aliases").get("aliasText")), cb.literal(likePattern)))
  );
  

• 性能优化：如果搜索频率高，建议给full_name和alias_text创建函数索引（比如create index idx_demo_person_lower_name on demo_person(lower(full_name));），大幅提升模糊查询的性能。

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