JPQL转Criteria Query：修正PostgreSQL子查询报错问题

错误原因 #

你遇到的org.postgresql.util.PSQLException是因为用来获取用户订单总消费最大值的子查询返回了多行数据，但JPA将其作为单行表达式（比如用=做比较），违反了PostgreSQL的语法规则。

修正后的Criteria Query代码 #

假设实体关联关系：User ←→ Order（一对多），User ←→ Tag（多对多/一对多），以下代码完全匹配正确JPQL的结构：

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<String> query = cb.createQuery(String.class);

// 主查询：从Tag出发关联User
Root<Tag> tag = query.from(Tag.class);
Join<Tag, User> user = tag.join("user"); // 替换为你的实际关联属性名

// 子查询1：计算每个用户的订单总消费
Subquery<BigDecimal> userTotalSub = query.subquery(BigDecimal.class);
Root<User> u1 = userTotalSub.from(User.class);
Join<User, Order> o1 = u1.join("orders"); // 替换为实际订单关联属性名
userTotalSub.select(cb.sum(o1.get("amount"))) // 替换为订单金额属性名
            .groupBy(u1.get("id"));

// 子查询2：获取所有用户总消费中的最大值（确保返回单行）
Subquery<BigDecimal> maxTotalSub = query.subquery(BigDecimal.class);
Root<User> u2 = maxTotalSub.from(User.class);
Join<User, Order> o2 = u2.join("orders");
maxTotalSub.select(cb.max(cb.sum(o2.get("amount"))))
           .groupBy(u2.get("id"));

// 子查询3：筛选出总消费等于最大值的用户ID
Subquery<Long> topUsersSub = query.subquery(Long.class);
Root<User> u3 = topUsersSub.from(User.class);
Join<User, Order> o3 = u3.join("orders");
topUsersSub.select(u3.get("id"))
           .groupBy(u3.get("id"))
           .having(cb.equal(cb.sum(o3.get("amount")), maxTotalSub));

// 组装主查询：取最高消费用户的最常用标签
query.select(tag.get("name")) // 替换为标签名称属性名
     .where(user.get("id").in(topUsersSub))
     .groupBy(tag.get("name"))
     .orderBy(cb.desc(cb.count(tag)))
     .setMaxResults(1);

// 执行查询
String mostUsedTag = entityManager.createQuery(query).getSingleResult();

核心修正点 #

• 给最大值子查询套了一层MAX()聚合：确保最终返回单个最大值，避免多行结果作为表达式使用。
• 用IN匹配最高消费用户ID：兼容多个用户总消费并列第一的场景，若业务保证唯一最高，可改用=但需确保子查询单行返回。
• 分层构建嵌套子查询：完全对齐JPQL的结构，避免子查询逻辑混乱导致的语法错误。

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