如何将JPQL查询内的计算值映射到Spring Boot项目中的JPA实体类？

当JPQL的SELECT子句同时返回实体和额外计算列时，JPA规范会统一将每行查询结果封装为Object[]数组，数组内元素的顺序和SELECT子句的列顺序一一对应，不会自动把非实体列的值赋值给实体的@Transient属性。
你直接将返回的Object[]数组强转为School实体类型，自然会触发数组无法强转为实体类的类型转换异常。哪怕你在实体里定义了和计算列别名同名的@Transient字段，JPA的实体赋值流程也不会读取这部分额外的计算列——@Transient注解仅用于声明属性不需要和数据库表字段做映射，没有“自动接收查询计算值”的作用。

根据后续要扩展到聚合统计的需求，推荐两种落地方式：

方案1：构造器表达式（最适配扩展场景） #

通过JPQL的NEW语法绑定自定义POJO构造器，直接返回封装了实体和计算值的对象，彻底避免Object[]的类型转换问题：

1. 定义纯POJO查询载体（不要加任何JPA注解），包含全参构造器：

// 包路径按实际项目填写
public class SchoolWithStatDTO {
    // 托管实体本身
    private School school;
    // 计算/聚合字段，注意类型和计算值匹配，原示例的9876为数字类型，建议用Long/Integer而非String
    private Long num;
    // 必须定义和SELECT列顺序一致的全参构造器，JPQL通过反射调用该构造器完成对象实例化
    public SchoolWithStatDTO(School school, Long num) {
        this.school = school;
        this.num = num;
    }
    // 补充对应getter方法保证JSON序列化正常
}

2. 修改对应的NamedQuery：

@NamedQuery(name = "School.findSchoolWithNum",
        query = "SELECT NEW com.xxx.dto.SchoolWithStatDTO(s, 9876 as num) " +
                "FROM School s " +
                "WHERE s.id = :schoolId")

后续要扩展聚合统计场景时，只需要修改SELECT的计算列逻辑即可，比如统计学校关联的学生总数：

// 聚合场景示例，无需修改DTO结构
query = "SELECT NEW com.xxx.dto.SchoolWithStatDTO(s, COUNT(stu.id) as num) " +
        "FROM School s LEFT JOIN s.students stu WHERE s.id = :schoolId"

方案2：手动映射计算值到实体@Transient字段 #

如果希望直接复用原School实体上的@Transient字段存储计算值，需要手动完成值的填充：

1. 保持原JPQL写法不变：

@NamedQuery(name = "findSchool",
        query = "SELECT s, 9876 as num FROM School s WHERE s.id = :schoolId")

2. 查询返回后手动遍历结果集做值映射：

// 按NamedQuery实际获取返回结果
List<Object[]> rows = em.createNamedQuery("findSchool")
        .setParameter("schoolId", schoolId)
        .getResultList();
List<School> result = rows.stream().map(row -> {
    School school = (School) row[0];
    // 手动将计算列的值赋值到实体的@Transient字段，注意做类型转换
    school.setNum(String.valueOf(row[1]));
    return school;
}).toList();

• JPA没有“查询列别名和@Transient字段同名就自动赋值”的机制，实体的属性填充仅来自ORM映射对应的表列，和自定义查询别名没有关联
• 注意计算值的类型和目标属性匹配，示例中整数9876映射到String类型的num字段时，必须显式做类型转换，避免运行时类型不匹配异常
• 用于查询返回的DTO为纯POJO即可，不要叠加JPA托管注解，避免和实体生命周期管理逻辑冲突

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