Spring JPA查询返回重复User实体的问题排查咨询

出现重复User的原因是：查询时JPA会自动关联User和Order表执行JOIN操作，每个符合状态条件的Order都会对应返回一条User记录，导致同一个User被多次返回。

以下是几种可行的解决办法：

方法一：使用Spring Data JPA的Distinct方法命名规则 #

直接在Repository方法名中加入Distinct关键字，让查询自动去重：

@Repository
public interface UserDao extends JpaRepository<User, UUID> {
    Page<User> findDistinctByOrders_OrderStatus(OrderStatus orderStatus, Pageable pageable);
}

方法二：自定义@Query语句并添加DISTINCT #

通过JPQL手动编写查询语句，使用DISTINCT关键字确保返回唯一的User实体：

@Repository
public interface UserDao extends JpaRepository<User, UUID> {
    @Query("SELECT DISTINCT u FROM User u JOIN u.orders o WHERE o.orderStatus = :orderStatus")
    Page<User> findAllByOrders_OrderStatus(@Param("orderStatus") OrderStatus orderStatus, Pageable pageable);
}

方法三：通过结果集手动去重（不推荐） #

如果上述方法无法使用，也可以在查询后对结果集进行去重处理，利用Set的特性实现：

// 调用Repository查询后处理结果
Page<User> userPage = userDao.findAllByOrders_OrderStatus(orderStatus, pageable);
Set<User> uniqueUsers = new HashSet<>(userPage.getContent());
List<User> uniqueUserList = new ArrayList<>(uniqueUsers);
// 重新构造分页对象（需保留分页信息时使用）
Page<User> uniqueUserPage = new PageImpl<>(uniqueUserList, userPage.getPageable(), userPage.getTotalElements());

注意：这种方法会在内存中处理数据，数据量较大时会影响性能，优先推荐前两种方法。

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