JPA计算投影分页异常：引用不存在字段f2的解决方案咨询

问题根源 #

当使用Pageable分页时，Spring Data JPA会默认将排序参数映射到原实体（EntityA）的字段，但你的f2、f3是查询中通过聚合函数生成的别名，并非EntityA的固有字段，因此会生成错误的order by a.f2语句。

解决方案步骤 #

1. 正确构建投影实体 #

投影实体需要和查询结果的字段别名一一对应，支持类投影或接口投影两种方式：

类投影（推荐，支持复杂场景）

import java.math.BigDecimal;

public class ProjectionEntity {
    private String f1;
    private BigDecimal f2;
    private BigDecimal f3;

    // 构造函数参数顺序必须与SELECT语句的字段顺序完全一致
    public ProjectionEntity(String f1, BigDecimal f2, BigDecimal f3) {
        this.f1 = f1;
        this.f2 = f2;
        this.f3 = f3;
    }

    // 必须提供Getter方法，Spring Data需通过Getter读取映射值
    public String getF1() { return f1; }
    public BigDecimal getF2() { return f2; }
    public BigDecimal getF3() { return f3; }
}

接口投影（轻量场景）

import java.math.BigDecimal;

public interface ProjectionEntity {
    String getF1();
    BigDecimal getF2();
    BigDecimal getF3();
}

2. 修正JPQL查询语句 #

原查询缺少GROUP BY子句（使用聚合函数SUM必须分组非聚合字段），同时需指定countQuery用于分页统计总条数，避免Spring Data自动生成错误的统计SQL：

import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.Repository;

public interface EntityARepository extends Repository<EntityA, String> {

    @Query(value = """
        SELECT 
          a.field1 as f1,
          SUM(b.some_column) as f2,  -- 替换为实际聚合逻辑
          SUM(b.other_column) as f3  -- 替换为实际聚合逻辑
        FROM EntityA a
          LEFT JOIN EntityB b ON a.field1 = b.field1
        WHERE a.field2 = :field2
        GROUP BY a.field1  -- 必须按非聚合字段分组
        """,
        countQuery = """
            SELECT COUNT(DISTINCT a.field1)
            FROM EntityA a
              LEFT JOIN EntityB b ON a.field1 = b.field1
            WHERE a.field2 = :field2
            """)
    Page<ProjectionEntity> getSomeCalculatedData(String field2, Pageable pageable);
}

3. 处理分页排序 #

要让Spring Data使用查询结果的别名进行排序，而非原实体字段，有两种可行方式：

方式一：使用原生查询

添加nativeQuery = true，让排序直接作用于查询别名，避免JPA的字段映射错误：

@Query(value = """
    SELECT 
      a.field1 as f1,
      SUM(b.some_column) as f2,
      SUM(b.other_column) as f3
    FROM entity_a a
      LEFT JOIN entity_b b ON a.field1 = b.field1
    WHERE a.field2 = :field2
    GROUP BY a.field1
    """,
    countQuery = """
        SELECT COUNT(DISTINCT a.field1)
        FROM entity_a a
          LEFT JOIN entity_b b ON a.field1 = b.field1
        WHERE a.field2 = :field2
        """,
    nativeQuery = true)
Page<ProjectionEntity> getSomeCalculatedData(String field2, Pageable pageable);

此时传入Pageable时，直接使用投影属性名排序即可，例如：

Pageable pageable = PageRequest.of(0, 10, Sort.by("f2").descending());
repository.getSomeCalculatedData("xxx", pageable);

方式二：自定义排序映射

如果坚持使用JPQL，可通过Sort的字段配置明确指向查询别名，或使用Criteria API构建查询，手动关联排序字段到查询结果的别名。

关键注意事项 #

• 使用聚合函数（如SUM）时必须添加GROUP BY子句，否则无论是否分页都会报错。
• 投影实体的属性名必须与查询中的别名严格对应（类投影的构造函数顺序、接口投影的Getter方法名）。
• 分页统计的countQuery需单独编写，避免Spring Data自动生成包含聚合函数的错误统计SQL。

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