如何用JPA Criteria API实现带子查询Join的学生信息查询？

针对你遇到的结果重复、分组字段繁琐的问题，核心解法是把成绩聚合逻辑剥离到子查询中，主查询只关联基础实体和聚合子查询，彻底避免主查询分组的麻烦。

实现步骤 #

1. 构建成绩聚合子查询 #

先单独生成按学生ID聚合成绩的子查询，返回学生ID和拼接后的成绩字符串：

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
// 子查询返回Tuple，包含学生ID和聚合成绩
Subquery<Tuple> scoreSubquery = criteriaQuery.subquery(Tuple.class);
Root<TestResult> testResultRoot = scoreSubquery.from(TestResult.class);

scoreSubquery.select(cb.tuple(
    testResultRoot.get("student").get("id").alias("studentId"),
    cb.function("string_agg", String.class,
        testResultRoot.get("score"), // 替换为你的成绩字段名
        cb.literal(", ") // 成绩分隔符
    ).alias("aggregatedScores")
)).groupBy(testResultRoot.get("student").get("id"));

2. 主查询关联子查询与基础实体 #

主查询以Student为根，关联StudentCard后，通过学生ID关联聚合子查询，直接映射到StudentInfoDTO：

CriteriaQuery<StudentInfoDTO> criteriaQuery = cb.createQuery(StudentInfoDTO.class);
Root<Student> studentRoot = criteriaQuery.from(Student.class);

// 关联学生证实体（按需调整Join类型，比如LEFT JOIN）
Join<Student, StudentCard> studentCardJoin = studentRoot.join("studentCard", JoinType.INNER);

// 将子查询作为虚拟表关联到主查询
Join<Object, Tuple> scoreJoin = studentRoot.join(
    "id", JoinType.LEFT,
    cb.equal(studentRoot.get("id"), scoreSubquery.getSelection().get("studentId"))
);

// 构造DTO结果
criteriaQuery.select(cb.construct(
    StudentInfoDTO.class,
    studentRoot.get("id"),
    studentRoot.get("name"),
    scoreJoin.get("aggregatedScores"),
    studentCardJoin.get("cardNumber") // 替换为你的学生证号字段名
));

// 确保每个学生仅返回一条记录
criteriaQuery.distinct(true);

// 执行查询
List<StudentInfoDTO> result = entityManager.createQuery(criteriaQuery).getResultList();

3. 简化方案：子查询直接作为SELECT字段 #

如果不想用Join子查询，也可以把聚合逻辑直接嵌入SELECT列表，写法更简洁：

// 子查询直接返回当前学生的聚合成绩
Subquery<String> scoreSubquery = criteriaQuery.subquery(String.class);
Root<TestResult> trRoot = scoreSubquery.from(TestResult.class);
scoreSubquery.select(cb.function("string_agg", String.class, trRoot.get("score"), cb.literal(", ")))
    .where(cb.equal(trRoot.get("student").get("id"), studentRoot.get("id")))
    .groupBy(trRoot.get("student").get("id"));

// 主查询直接引用子查询作为字段
criteriaQuery.select(cb.construct(
    StudentInfoDTO.class,
    studentRoot.get("id"),
    studentRoot.get("name"),
    scoreSubquery,
    studentCardJoin.get("cardNumber")
));

这种方式生成的SQL会在SELECT中嵌套子查询，同样能避免主查询分组，且不会产生重复结果。

关键注意事项 #

• 确保你的JPA提供者（如Hibernate）支持string_agg函数，若不支持，需注册自定义函数适配数据库语法。
• 若存在无考试成绩的学生，使用LEFT JOIN子查询，避免这类学生被过滤，DTO中可将null成绩处理为空字符串。
• 主查询无需添加分组逻辑，因为聚合已在子查询中完成，主查询仅做关联查询。

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