JPA使用DISTINCT查询时按嵌套属性排序的问题求解

问题根因 #

你遇到的报错是严格遵循SQL标准的数据库（如PostgreSQL、MySQL 8.0+高版本）的强制校验规则：当查询使用SELECT DISTINCT时，ORDER BY后指定的字段必须出现在SELECT的返回列中，否则数据库无法保证去重后结果的排序一致性。
默认的Spring Data派生查询findDistinct(Pageable)生成SQL时，只会将主实体Entity1的字段加入SELECT列表，关联表Entity2的fieldToSort仅用于排序未加入返回列，因此触发校验失败。如果直接去掉DISTINCT，多表关联的笛卡尔积会导致同一条Entity1记录返回多次，出现重复数据。

最优解决方案 #

优先推荐自定义JPQL查询显式关联拉取排序字段的方案，既符合SQL规范，又能保证去重、排序、分页逻辑全部在数据库层面完成，性能和准确性最高：

1. 调整Repository方法定义 #

修改Entity1Repository的查询方法，通过LEFT JOIN FETCH显式拉取关联的Entity2，同时自定义count查询保证分页计数准确：

public interface Entity1Repository extends JpaRepository<Entity1, Long> {
    @Query(
        value = "SELECT DISTINCT e1 FROM Entity1 e1 LEFT JOIN FETCH e1.entity2 e2",
        countQuery = "SELECT COUNT(DISTINCT e1.id) FROM Entity1 e1"
    )
    Page<Entity1> findDistinctWithEntity2Sort(Pageable pageable);
}

2. 构造分页参数直接按关联字段排序 #

调用时直接传入关联属性路径作为排序字段即可，不会再触发报错：

// 按entity2的fieldToSort降序分页查询
Pageable pageable = PageRequest.of(0, 10, Sort.by(Sort.Direction.DESC, "entity2.fieldToSort"));
Page<Entity1> result = entity1Repository.findDistinctWithEntity2Sort(pageable);

方案说明 #

• LEFT JOIN FETCH会将Entity2的所有字段加入SELECT返回列表，排序字段fieldToSort自然满足DISTINCT的校验要求
• 显式指定countQuery用COUNT(DISTINCT e1.id)计数，避免关联表导致的分页总数统计错误
• 去重逻辑在数据库层面完成，不会出现内存去重导致的分页页数不准、数据量过大OOM的问题

备选兼容方案 #

如果项目中不允许自定义JPQL，可以使用Spring Data JPA的Specification构造查询，显式将排序的关联字段加入查询的选择列表，效果和自定义JPQL一致，只是代码复杂度更高。

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