如何在JPQL查询中直接构造含关联对象列表的DTO？

现有如下JPA实体类：

@Getter
@Entity
class TopLevel {
    @Column
    String name;
    @OneToMany
    List<SubTypeOne> subtypes;
}

@Getter
@Entity
class SubTypeOne {
    @ManyToOne()
    SubTypeTwo property;
}

@Getter
@Entity
class SubTypeTwo {
    @Column
    int finalProperty;
}

对应的DTO定义：

record TopLevelDto(String name, Collection<Integer> subTypeTwoProperties) {}

目前通过先查询TopLevel实体，再通过Stream转换为DTO：

String query = """
               SELECT t
               FROM TopLevel t
               LEFT JOIN FETCH t.subtypes st
               LEFT JOIN FETCH st.property
               """;
// 获取TopLevel对象的代码省略
TopLevel t = /* 查询结果 */;
List<Integer> subTypeTwoProperties = t.getSubtypes().stream()
    .map(s -> s.getProperty().getFinalProperty())
    .toList();
TopLevelDto dto = new TopLevelDto(t.getName(), subTypeTwoProperties);

希望直接在JPQL查询中完成DTO的构建，比如类似假设的collect_list函数实现如下效果：

SELECT new TopLevelDto(t.name, collect_list(st.property.finalProperty))
FROM TopLevel t
LEFT JOIN FETCH t.subtypes st
LEFT JOIN FETCH st.property

询问是否存在此类函数或替代方案。

当然可以直接在JPQL中完成这类DTO投影，以下是几种可行方案：

1. 数据库原生聚合函数（JPA通用） #

多数主流数据库都提供了聚合为集合的原生函数，JPA 2.1+支持直接调用这些函数。例如：

• PostgreSQL用array_agg
• MySQL用GROUP_CONCAT（返回字符串，需后续拆分转换）

以PostgreSQL为例，JPQL写法如下：

String query = """
               SELECT new TopLevelDto(t.name, array_agg(st.property.finalProperty))
               FROM TopLevel t
               LEFT JOIN t.subtypes st
               LEFT JOIN st.property
               GROUP BY t.id, t.name
               """;

注意：必须按TopLevel的主键（如id，实体未显式定义则用JPA隐式主键）和name分组，避免返回重复的TopLevel结果。

2. Hibernate专属collect函数 #

如果使用Hibernate作为JPA实现，可以用它内置的collect函数，无需依赖数据库特定语法：

String query = """
               SELECT new TopLevelDto(t.name, collect(st.property.finalProperty))
               FROM TopLevel t
               LEFT JOIN t.subtypes st
               LEFT JOIN st.property
               GROUP BY t.id, t.name
               """;

这个函数会自动处理集合聚合，兼容性更好。

3. 关键注意事项 #

不要在聚合查询中使用JOIN FETCH——FETCH的作用是加载实体关联，而聚合查询是直接投影字段，混用会导致结果重复或查询异常，改用普通LEFT JOIN即可。

4. 进阶替代方案：Blaze-Persistence Entity Views #

如果需要更复杂的DTO映射场景，可以使用Blaze-Persistence Entity Views库，它支持直接将JPQL查询结果映射到DTO，无需手动编写聚合逻辑：

@EntityView(TopLevel.class)
interface TopLevelDto {
    String getName();
    @Mapping("subtypes.property.finalProperty")
    Collection<Integer> getSubTypeTwoProperties();
}

之后直接查询该视图即可，底层会自动生成正确的聚合SQL语句。

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