1. 概述
Spring Data JPA 能帮我们自动生成基础的实体查询，但在某些场景下，我们需要对查询进行定制化处理——比如加入了聚合函数（aggregation functions）的查询。
本文重点讨论：如何将这类聚合查询的结果映射为 Java 对象。我们会介绍两种主流方案：
✅ 基于 JPA 规范的构造器表达式（Constructor Expression）
✅ 使用 Spring Data 的 Projection 机制（接口投影）
两种方式都能优雅解决 Object[] 返回值带来的类型不安全问题，避免踩坑。
2. JPA 查询与聚合结果的“形状”问题
JPA 查询默认返回的是实体类实例。但一旦用了 COUNT、SUM 这类聚合函数，查询结果就不再是完整的实体，而是“扁平化”的数据行。
此时，JPA 会把结果封装成 Object[] 数组，这非常不友好：
- ❌ 类型不安全，需要手动强转
- ❌ 容易出错，索引顺序一变就崩
- ❌ 代码可读性差，维护成本高
我们以博客系统中 文章（Post）与评论（Comment） 的一对多关系为例：
@Entity
public class Post {
@Id
private Integer id;
private String title;
private String content;
@OneToMany(mappedBy = "post")
private List<Comment> comments;
// 标准构造器、getter/setter 省略
}
@Entity
public class Comment {
@Id
private Integer id;
private Integer year;
private boolean approved;
private String content;
@ManyToOne
private Post post;
// 标准构造器、getter/setter 省略
}
配套的 Repository 接口如下：
@Repository
public interface CommentRepository extends JpaRepository<Comment, Integer> {
// 自定义查询方法
}
现在我们想统计每年评论总数：
@Query("SELECT c.year, COUNT(c.year) FROM Comment AS c GROUP BY c.year ORDER BY c.year DESC")
List<Object[]> countTotalCommentsByYear();
⚠️ 问题来了：这个查询返回的是 List<Object[]>，每个数组包含两个元素：
Object[0]→ 年份（Integer）Object[1]→ 数量（Long）
你总不能在业务层写一堆 result.get(0)[0] 吧？太容易出错，也完全违背了面向对象的设计理念。
3. 使用类构造器自定义结果（JPA Constructor Expression）
JPA 提供了一个优雅的解决方案：通过构造器表达式直接将查询结果映射为 POJO。
核心思路：在 JPQL 中使用 SELECT new 语法，调用指定类的构造函数。
@Query("SELECT new com.baeldung.aggregation.model.custom.CommentCount(c.year, COUNT(c.year)) "
+ "FROM Comment AS c GROUP BY c.year ORDER BY c.year DESC")
List<CommentCount> countTotalCommentsByYearClass();
✅ 要点：
new后必须写 全限定类名- 构造函数参数顺序和类型必须与查询字段严格匹配
- 该类无需加
@Entity，就是一个普通 POJO
对应的 CommentCount 类定义如下：
package com.baeldung.aggregation.model.custom;
public class CommentCount {
private Integer year;
private Long total;
public CommentCount(Integer year, Long total) {
this.year = year;
this.total = total;
}
// getter 和 setter
public Integer getYear() {
return year;
}
public void setYear(Integer year) {
this.year = year;
}
public Long getTotal() {
return total;
}
public void setTotal(Long total) {
this.total = total;
}
}
✅ 优势：
- 类型安全，返回值是
List<CommentCount> - 不依赖 Spring 特性，纯 JPA 实现
- 适合复杂聚合或跨表计算
⚠️ 注意事项：
- 构造函数必须存在且可访问
- 参数数量、顺序、类型必须完全一致
- 如果字段多或类型复杂，POJO 维护成本会上升
4. 使用 Spring Data Projection 自定义结果
Spring Data JPA 提供了更轻量的方案：Projection（投影）。它允许我们用接口来声明期望的结果结构，Spring 会自动帮你生成代理对象填充数据。
简单粗暴地说：你定义接口，Spring 给你实现。
4.1 JPQL 查询中的接口投影
首先定义一个接口，方法名需与查询字段别名匹配：
public interface ICommentCount {
Integer getYearComment();
Long getTotalComment();
}
然后在查询中使用别名（AS）绑定字段：
@Query("SELECT c.year AS yearComment, COUNT(c.year) AS totalComment "
+ "FROM Comment AS c GROUP BY c.year ORDER BY c.year DESC")
List<ICommentCount> countTotalCommentsByYearInterface();
✅ 关键点：
- 必须使用
AS给字段起别名 - 别名要和接口中的 getter 方法名对应（去掉
get，首字母小写） - Spring 会在运行时生成代理对象，自动注入值
例如：AS yearComment → getYearComment() → 注入到接口实现中。
返回结果是 List<ICommentCount>，可以直接 .getYearComment() 使用，清爽又安全。
4.2 原生 SQL 查询中的接口投影
有时候 JPQL 性能不够或无法使用数据库特有功能，就得上 原生 SQL（native query）。
好消息是：Spring Data Projection 同样支持原生 SQL！
继续复用上面的 ICommentCount 接口：
@Query(value = "SELECT c.year AS yearComment, COUNT(c.*) AS totalComment "
+ "FROM comment AS c GROUP BY c.year ORDER BY c.year DESC", nativeQuery = true)
List<ICommentCount> countTotalCommentsByYearNative();
⚠️ 注意：
- 表名和字段名要用数据库实际的命名（如
comment而非Comment） - 依然要使用
AS别名匹配接口方法 nativeQuery = true不可省略
效果和 JPQL 完全一样，Spring 依然会返回代理对象列表。
✅ 优势总结：
- 零实现类，接口即契约
- 支持 JPQL 和原生 SQL
- 代码量极小，维护成本低
- 天然支持只查部分字段（避免 SELECT *）
5. 总结
面对 JPA 聚合查询返回 Object[] 的尴尬局面，我们有两种成熟方案可选：
| 方案 | 技术基础 | 适用场景 |
|---|---|---|
| ✅ 构造器表达式 | JPA 标准 | 需要跨实体聚合、逻辑复杂、追求规范兼容性 |
| ✅ Spring Data Projection | Spring 扩展 | 快速开发、轻量级 DTO、原生 SQL 场景 |
📌 推荐实践：
- 日常开发优先使用 Projection 接口，简洁高效
- 若需复用或复杂计算，再考虑 构造器 + POJO
- 别再遍历
Object[]了，那是技术债的开始
示例代码已托管至 GitHub：https://github.com/baeldung/spring-data-jpa-tutorials
分支：aggregation-projection