JPA @Query分页转DTO报错：无法解析YearlyReview的gid属性

错误原因 #

报错是因为排序字段用了gid，但JPA会默认从根实体YearlyReview中查找该属性，而YearlyReview本身没有gid字段——gid是关联实体ApplicationUser的属性，因此无法解析。

解决方案 #

1. 修正排序字段 #

构建Sort对象时，将排序字段从gid改为user.gid，让JPA能正确导航到关联实体的属性：

sortDir.equalsIgnoreCase(Sort.Direction.ASC.name()) 
    ? Sort.by("user.gid").ascending() 
    : Sort.by("user.gid").descending();

2. 确认DTO构造方法匹配 #

确保HRTableEntity存在与@Query中选择字段顺序、类型完全一致的构造方法：

public class HRTableEntity {
    private String gid;
    private String userId;
    private String fullName;
    private String position;
    private LocalDateTime created;
    private String genericField1;
    private String genericField2;

    // 参数顺序、类型必须和@Query的select列表严格对应
    public HRTableEntity(String gid, String userId, String fullName, String position, LocalDateTime created, String genericField1, String genericField2) {
        this.gid = gid;
        this.userId = userId;
        this.fullName = fullName;
        this.position = position;
        this.created = created;
        this.genericField1 = genericField1;
        this.genericField2 = genericField2;
    }

    // 按需添加getter、setter
}

3. 可选：优化查询性能（避免N+1问题） #

如果担心关联查询的性能，可以在@Query中加入join fetch yr.user，确保一次查询获取所有所需数据：

@Query(value = "select new base.models.HRTableEntity( yr.user.gid,  yr.user.id,  yr.user.lastName || ' ' || yr.user.firstName,  yr.user.position,  yr.user.created,yr.genericField1,yr.genericField2) from YearlyReview yr join fetch yr.user where yr.year = :yr and yr.user.realDepartment = :dep and yr.user.city = :ct",
        countQuery = "select count(yr.id) from YearlyReview yr where yr.year = :yr and yr.user.realDepartment = :dep and yr.user.city = :ct",
        nativeQuery = false)
Page<HRTableEntity> getAllTableEntity(Pageable pageRequest, @Param("yr") int year, @Param("dep") String department, @Param("ct") String location);

关键说明 #

• JPA的Sort字段需要遵循实体属性路径，关联实体的属性必须通过.导航，比如user.gid对应YearlyReview.user.gid。
• countQuery无需修改，因为它仅统计YearlyReview的数量，与关联实体无关。

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