Spring JPA查询返回多DTO而非合并PhoneNumber至列表的问题解决

你的问题根源是JPA JOIN查询产生了笛卡尔积，每条Person与PhoneNumber的关联记录都会生成一个DTO实例，Hibernate不会自动合并列表（因为实体间未定义关联关系）。以下是几种可行的解决方式：

方法一：手动组装DTO（推荐，简单易维护） #

通过两次独立查询获取Person和对应的PhoneNumber列表，再手动组装成目标DTO。

1. 在Repository中添加两个基础查询方法：

// PersonRepository
Optional<Person> findByACommonId(Long commonId);

// PhoneNumberRepository
List<PhoneNumber> findByACommonId(Long commonId);

2. 在业务逻辑层组装DTO：

public DTO getPersonWithPhones(Long commonId) {
    Person person = personRepository.findByACommonId(commonId)
            .orElseThrow(() -> new RuntimeException("未找到对应Person"));
    List<PhoneNumber> phoneNumbers = phoneNumberRepository.findByACommonId(commonId);
    return new DTO(person, phoneNumbers);
}

这种方式逻辑清晰，易于调试和维护，适合数据量不大的场景，虽然是两次查询，但性能开销通常可以忽略。

方法二：使用Hibernate ResultTransformer合并结果（单查询方案） #

借助Hibernate的ResultTransformer手动处理查询结果，将重复的Person对应的PhoneNumber合并到同一个列表中。

1. 创建自定义Repository实现：

@Repository
public class PersonCustomRepository {

    @PersistenceContext
    private EntityManager entityManager;

    public DTO getDTO(Long commonId) {
        String jpql = "SELECT p, a FROM Person p JOIN PhoneNumber a ON p.aCommonId = a.aCommonId WHERE p.aCommonId = :commonId";
        Query query = entityManager.createQuery(jpql)
                .setParameter("commonId", commonId);

        return query.unwrap(org.hibernate.query.Query.class)
                .setResultTransformer(new ResultTransformer() {
                    private final Map<Long, DTO> dtoCache = new HashMap<>();

                    @Override
                    public Object transformTuple(Object[] tuple, String[] aliases) {
                        Person person = (Person) tuple[0];
                        PhoneNumber phone = (PhoneNumber) tuple[1];

                        DTO dto = dtoCache.get(person.getId());
                        if (dto == null) {
                            dto = new DTO(person, new ArrayList<>());
                            dtoCache.put(person.getId(), dto);
                        }
                        dto.getPhoneNumbers().add(phone);
                        return dto;
                    }

                    @Override
                    public List transformList(List collection) {
                        return new ArrayList<>(dtoCache.values());
                    }
                })
                .getResultList()
                .stream()
                .findFirst()
                .orElseThrow(() -> new RuntimeException("未找到对应数据"));
    }
}

此方案仅需一次数据库查询，但依赖Hibernate原生API，耦合性相对较高。

方法三：JPQL子查询构造DTO（依赖JPA实现支持） #

通过JPQL子查询直接获取PhoneNumber列表，传入DTO构造器：

@Query("SELECT new com.yourpackage.DTO(p, (SELECT a FROM PhoneNumber a WHERE a.aCommonId = p.aCommonId)) " +
        "FROM Person p WHERE p.aCommonId = :commonId")
Optional<DTO> getDTO(@Param("commonId") Long commonId);

注意：部分JPA实现可能对子查询返回集合的语法有版本限制，需要测试验证。

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