Spring Boot中使用javax.persistence.Tuple执行原生查询报错如何解决？

首先明确：原生查询完全可以返回javax.persistence.Tuple，但你的写法有误——你调用em.createNativeQuery(QUERY_STRING, Tuple.class)时，第二个参数被Hibernate当成了需要映射的实体类，而Tuple并不是被JPA/Hibernate管理的实体，因此抛出了MappingException: Unknown entity: javax.persistence.Tuple的错误。

错误原因拆解 #

EntityManager.createNativeQuery(String sql, Class<T> resultClass)这个重载方法的设计目的，是将原生查询结果直接映射到被@Entity标记的实体类上。而Tuple是JPA提供的通用结果容器，不属于实体范畴，所以Hibernate无法识别它。

正确实现方案 #

下面提供两种可行的实现方式，分别适配JPA标准API和Hibernate特定扩展：

方案1：基于JPA标准API获取Tuple结果

不需要在createNativeQuery中指定实体类，直接调用getResultList()并指定泛型为Tuple即可，但要确保查询的每个列都设置别名（这样Tuple才能通过别名精准取值）：

String QUERY_STRING = "SELECT id AS userId, username AS userName FROM user WHERE id = ?";
Query q = em.createNativeQuery(QUERY_STRING);
q.setParameter(1, param1);
// 直接指定泛型为Tuple，获取结果列表
List<Tuple> resultList = q.getResultList();

// 遍历结果示例
for (Tuple tuple : resultList) {
    Integer userId = tuple.get("userId", Integer.class);
    String userName = tuple.get("userName", String.class);
    // 业务逻辑处理
}

方案2：使用Hibernate专属的TupleResultTransformer

如果不想给列加别名，或者需要更灵活的结果转换逻辑，可以借助Hibernate提供的TupleResultTransformer：

import org.hibernate.transform.TupleResultTransformer;

String QUERY_STRING = "SELECT id, username FROM user WHERE id = ?";
// 强制转换为Hibernate的NativeQuery类型
NativeQuery q = (NativeQuery) em.createNativeQuery(QUERY_STRING);
q.setParameter(1, param1);
// 设置结果转换器为TupleResultTransformer
q.setResultTransformer(new TupleResultTransformer());
List<Tuple> resultList = q.getResultList();

// 遍历结果示例（通过索引取值）
for (Tuple tuple : resultList) {
    Integer userId = tuple.get(0, Integer.class);
    String userName = tuple.get(1, String.class);
    // 业务逻辑处理
}

额外提示 #

• Spring Boot 1.5.13.RELEASE对应的Hibernate版本是5.0.x，上述两种方案在该版本中均可正常运行。
• 如果你的查询仅需返回少量字段，也可以考虑将结果映射到自定义DTO类（比如通过@SqlResultSetMapping或Hibernate的ResultTransformer），这也是原生查询中常用的优化方式。

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