如何将JPA多关联命名查询结果映射为目标POJO？

首先，核心问题在于你的@NamedQuery没有和定义的@SqlResultSetMapping关联起来，JPA不知道需要将结果映射到你的ProfileSummaryPojo，所以默认返回Object[]。另外，由于是一对多的左连接查询，结果会包含重复的ProfileSummary数据（每个Address对应一行），需要处理成单个带Address集合的POJO。

下面给出两种可行的解决方案：

方案一：关联@SqlResultSetMapping到NamedQuery #

1. 修改@NamedQuery，添加resultSetMapping属性 #

更新你的命名查询，指定使用你定义的结果集映射：

@NamedQuery(
    name = "SummaryQuery",
    query = "SELECT p.dId, p.hashedId, p.lanCode, p.markCode, a FROM ProfileSummary p LEFT JOIN FETCH Address a ON a.id.dId = p.dId WHERE p.dId = :dId",
    resultSetMapping = "SummaryQueryMapping" // 关联到你的结果集映射名称
)

2. 完善@SqlResultSetMapping #

因为你的POJO需要包含Address数据，要在映射中指定Address的字段或实体类型。如果Address是JPA实体，你可以直接映射到实体类型：

@SqlResultSetMapping(
    name = "SummaryQueryMapping",
    classes = @ConstructorResult(
        targetClass = ProfileSummaryPojo.class,
        columns = {
            @ColumnResult(name = "dId"),
            @ColumnResult(name = "hashedId"),
            @ColumnResult(name = "lanCode"),
            @ColumnResult(name = "markCode"),
            @ColumnResult(name = "a", type = Address.class) // 映射Address实体
        }
    )
)

3. 确保ProfileSummaryPojo有对应构造函数 #

你的POJO需要提供匹配参数顺序的构造函数：

public class ProfileSummaryPojo {
    private Long dId;
    private String hashedId;
    private String lanCode;
    private String markCode;
    private List<Address> addresses = new ArrayList<>();

    // 注意：这里的构造函数接收单个Address，后续我们会合并成集合
    public ProfileSummaryPojo(Long dId, String hashedId, String lanCode, String markCode, Address address) {
        this.dId = dId;
        this.hashedId = hashedId;
        this.lanCode = lanCode;
        this.markCode = markCode;
        if (address != null) {
            this.addresses.add(address);
        }
    }

    // getter和setter省略
}

4. 合并重复结果 #

由于左连接一对多会返回多行（每个Address对应一行），你需要在业务层合并相同dId的POJO实例，将Address合并到集合中：

List<ProfileSummaryPojo> rawResults = entityManager.createNamedQuery("SummaryQuery", ProfileSummaryPojo.class)
    .setParameter("dId", dIdValue)
    .getResultList();

// 合并结果
Map<Long, ProfileSummaryPojo> mergedMap = new HashMap<>();
for (ProfileSummaryPojo pojo : rawResults) {
    mergedMap.computeIfAbsent(pojo.getDId(), k -> pojo)
             .getAddresses()
             .addAll(pojo.getAddresses());
}

ProfileSummaryPojo finalResult = mergedMap.values().stream().findFirst().orElse(null);

方案二：使用JPQL构造函数表达式（更简洁） #

不需要定义@SqlResultSetMapping，直接在JPQL中使用new关键字构造POJO：

1. 修改@NamedQuery #

@NamedQuery(
    name = "SummaryQuery",
    query = "SELECT new com.yourpackage.ProfileSummaryPojo(p.dId, p.hashedId, p.lanCode, p.markCode, a) FROM ProfileSummary p LEFT JOIN FETCH Address a ON a.id.dId = p.dId WHERE p.dId = :dId"
)

2. 同样处理构造函数和结果合并 #

和方案一的步骤3、4一致，构造函数接收单个Address，然后在业务层合并成带集合的POJO。

关键注意点 #

• 确保JPQL中SELECT的字段顺序和POJO构造函数的参数顺序完全一致。
• 如果Address也需要转成DTO而非实体，可以在JPQL中构造AddressDTO，比如new com.yourpackage.AddressDTO(a.id, a.street, ...)，然后POJO构造函数接收AddressDTO。
• 左连接一对多必然返回多行重复的主表数据，这是SQL的特性，所以合并步骤是不可避免的（除非使用数据库的聚合函数，但会丢失明细数据）。

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