JPA如何通过SqlResultSetMapping将原生查询结果映射为含嵌套POJO的类

问题原因 #

你当前抛出空指针的核心原因是 JPA 原生的@ColumnResult注解的type属性仅支持JDBC可直接映射的基础类型（包装类、字符串、日期等），不支持直接传入自定义POJO类做自动嵌套构造。你在注解中指定type=MySubPojo.class时，JPA无法将结果集中的列自动映射为自定义的MySubPojo实例，也找不到名为mySubPojo的结果列，因此触发空指针。

嵌套POJO映射的实现方案 #

这类嵌套结构的结果映射需求是完全合理的，常见于DTO数据组装场景，以下是两种稳定可落地的实现方式：

方案1：平铺列手动组装（无额外依赖、兼容性最好）

不需要依赖JPA的自动构造能力，先将所有嵌套字段平铺为结果列，拿到查询结果后手动组装为嵌套结构，实现成本低且完全可控：

1. 调整查询SQL，给所有字段加明确别名避免冲突：

Query query = this.entityManager.createNativeQuery(
    "SELECT r.firstSimpleAttribute, r.secondSimpleAttribute, r.thirdSimpleAttribute, " +
    "me.id, me.label, mse.text as sub_text " +
    "FROM result r " +
    "INNER JOIN my_entity me ON r.id_my_entity = me.id_my_entity " +
    "INNER JOIN my_sub_entity mse ON me.id_my_sub_entity = mse.id_my_sub_entity",
    "CustomMapping");

2. 调整@SqlResultSetMapping，所有列都声明为基础类型：

@SqlResultSetMapping(
    name = "CustomMapping",
    columns = {
        @ColumnResult(name = "firstSimpleAttribute", type = Integer.class),
        @ColumnResult(name = "secondSimpleAttribute", type = Integer.class),
        @ColumnResult(name = "thirdSimpleAttribute", type = Double.class),
        @ColumnResult(name="id", type=Long.class),
        @ColumnResult(name="label", type=String.class),
        @ColumnResult(name="sub_text", type=String.class)
    }
)

3. 拿到结果后手动组装嵌套结构：

List<Object[]> rows = query.getResultList();
List<ResultPojo> resultList = new ArrayList<>();
for (Object[] row : rows) {
    // 从内到外构造POJO
    MySubPojo subPojo = new MySubPojo((String) row[5]);
    MyPojo myPojo = new MyPojo((Long) row[3], (String) row[4], subPojo);
    ResultPojo resultPojo = new ResultPojo(myPojo, (Integer) row[0], (Integer) row[1], (Double) row[2]);
    resultList.add(resultPojo);
}

方案2：基于Tuple的别名映射（避免索引顺序错误）

如果使用Hibernate作为JPA实现，可以用Tuple类型返回结果，通过列名而非索引取值，避免列顺序调整后出现映射错误：

Query<Tuple> query = this.entityManager.createNativeQuery(
    "SELECT r.firstSimpleAttribute, r.secondSimpleAttribute, r.thirdSimpleAttribute, " +
    "me.id, me.label, mse.text as subText " +
    "FROM result r " +
    "INNER JOIN my_entity me ON r.id_my_entity = me.id_my_entity " +
    "INNER JOIN my_sub_entity mse ON me.id_my_sub_entity = mse.id_my_sub_entity",
    Tuple.class);

List<Tuple> tuples = query.getResultList();
List<ResultPojo> resultList = tuples.stream().map(tuple -> {
    MySubPojo subPojo = new MySubPojo(tuple.get("subText", String.class));
    MyPojo myPojo = new MyPojo(tuple.get("id", Long.class), tuple.get("label", String.class), subPojo);
    return new ResultPojo(
        myPojo,
        tuple.get("firstSimpleAttribute", Integer.class),
        tuple.get("secondSimpleAttribute", Integer.class),
        tuple.get("thirdSimpleAttribute", Double.class)
    );
}).toList();

这个方案不需要额外配置@SqlResultSetMapping，代码可读性更强。

额外说明 #

目前JPA规范本身没有提供原生SQL自动嵌套构造POJO的能力，所有自动映射的第三方工具本质也是封装了上述手动组装的逻辑，对于简单嵌套场景直接手动组装是性价比最高的选择。

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