JPA原生查询结果Map列名顺序不符，如何按SELECT语句顺序获取？

问题背景 #

我编写了如下原生查询语句：

String searchSql = "Select firstname,lastname from students order by id desc";

接着执行查询：

Query query = entityManager.createNativeQuery(searchSql);
List<Map<String, Object>> results = query.getResultList();

当我遍历结果Map的键来获取列名时：

List<String> headers = new ArrayList<>();
for(String header : results.get(0).keySet()){
    headers.add(header);
}

得到的列名顺序是随机的，并非SELECT语句中的顺序。本以为LinkedHashMap可以解决，但会出现类型转换异常，请问有什么通用的解决思路？

解决思路 #

1. 使用JPA标准的Tuple类型（推荐，跨实现通用）

我之前处理这类问题时，最先推荐用JPA自带的Tuple类型——它会严格保留SQL语句中列的顺序，而且不需要自定义实体类，非常灵活。

代码示例：

String searchSql = "Select firstname,lastname from students order by id desc";
// 创建查询时指定返回Tuple类型
Query query = entityManager.createNativeQuery(searchSql, Tuple.class);
List<Tuple> results = query.getResultList();

// 提取列名顺序
List<String> headers = new ArrayList<>();
if (!results.isEmpty()) {
    // 从Tuple的元数据中获取列别名，顺序和SQL完全一致
    for (TupleElement<?> element : results.get(0).getElements()) {
        headers.add(element.getAlias());
    }
}

// 遍历结果时按顺序取值
for (Tuple row : results) {
    String firstName = (String) row.get("firstname");
    String lastName = (String) row.get("lastname");
    // 业务逻辑处理
}

这个方法的优势是完全基于JPA标准API，不管你用Hibernate、EclipseLink还是其他JPA实现都能生效，不会有兼容性问题。

2. 自定义结果转换器，返回LinkedHashMap

如果你的业务逻辑必须依赖Map类型，可以通过自定义结果转换器，让JPA返回LinkedHashMap来强制保留顺序。以Hibernate为例（其他JPA实现逻辑类似，只需替换对应的转换器类）：

String searchSql = "Select firstname,lastname from students order by id desc";
Query query = entityManager.createNativeQuery(searchSql);

// 转成Hibernate的Query对象，自定义结果转换器
query.unwrap(org.hibernate.query.Query.class)
     .setResultTransformer(new org.hibernate.transform.ResultTransformer() {
         @Override
         public Object transformTuple(Object[] tuple, String[] aliases) {
             // 用LinkedHashMap存储，保证插入顺序和SQL列顺序一致
             Map<String, Object> map = new LinkedHashMap<>(aliases.length);
             for (int i = 0; i < aliases.length; i++) {
                 map.put(aliases[i], tuple[i]);
             }
             return map;
         }

         @Override
         public List transformList(List collection) {
             return collection;
         }
     });

List<Map<String, Object>> results = query.getResultList();
// 此时keySet()的顺序就是SQL中的列顺序
List<String> headers = new ArrayList<>(results.get(0).keySet());

核心思路就是自己构建LinkedHashMap，把SQL返回的列值按别名顺序存入，从根源上解决无序问题。

3. 提前解析SQL提取列名（兜底方案）

如果上面两种方法都不适用，你可以提前解析SQL语句，提取出SELECT子句中的列名，然后按这个顺序去Map中取值。这个方法不依赖JPA的返回类型，通用性极强，但只适合SQL格式比较规范的场景（比如没有复杂嵌套子查询、函数别名不复杂）。

代码示例：

String searchSql = "Select firstname,lastname from students order by id desc";
// 简单解析SELECT后的列名（假设SQL格式规范，没有嵌套子查询）
String selectPart = searchSql.split("from")[0].trim().substring(6); // 去掉"Select "前缀
List<String> headers = Arrays.stream(selectPart.split(","))
                            .map(String::trim)
                            .collect(Collectors.toList());

// 执行原有查询
Query query = entityManager.createNativeQuery(searchSql);
List<Map<String, Object>> results = query.getResultList();

// 按解析好的顺序遍历取值
for (Map<String, Object> row : results) {
    for (String header : headers) {
        Object value = row.get(header);
        // 业务逻辑处理
    }
}

这个方法的好处是不需要修改查询的返回类型，但如果SQL比较复杂（比如包含SELECT (a + b) as total ...或者嵌套子查询），解析逻辑需要相应调整。

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