如何在JpaRepository中将JPA查询结果映射为HashMap<Long,String>？

报错原因 #

JPA 原生查询默认不支持直接将返回的两列结果自动组装为HashMap<Long, String>结构，查询返回的每一行结果默认是Object[]类型，直接声明返回 HashMap 会触发映射失败异常。

实现方案 #

方案1：接收结果数组后手动转换（通用兼容所有JPA实现） #

1. 先修改Repository接口方法的返回类型：

@Query(value = "SELECT COM_PRG_PK, COM_DESCRIZIONE FROM com_comune ORDER BY com_descrizione", nativeQuery = true)
List<Object[]> findAllComuneIdAndDescrizione();

2. 在业务层将查询结果组装为Map：

import java.util.stream.Collectors;

// 业务层调用示例
public Map<Long, String> getComuneIdToNameMap() {
    List<Object[]> resultList = comComuneRepository.findAllComuneIdAndDescrizione();
    return resultList.stream()
        .collect(Collectors.toMap(
            item -> (Long) item[0], // 第一列为Long类型的键
            item -> (String) item[1], // 第二列为String类型的值
            (oldVal, newVal) -> oldVal // 可选：出现重复键时保留旧值，可根据业务调整冲突处理逻辑
        ));
}

方案2：使用接口投影实现类型安全转换（推荐） #

该方案避免了手动强转数组的风险，可读性和可维护性更高：

1. 先定义投影接口：

public interface ComuneProjection {
    Long getComPrgPk();
    String getComDescrizione();
}

2. 修改Repository方法，给列加别名和投影接口匹配：

@Query(value = "SELECT COM_PRG_PK AS comPrgPk, COM_DESCRIZIONE AS comDescrizione FROM com_comune ORDER BY com_descrizione", nativeQuery = true)
List<ComuneProjection> findAllComuneProjections();

3. 业务层组装Map：

import java.util.stream.Collectors;

public Map<Long, String> getComuneIdToNameMap() {
    return comComuneRepository.findAllComuneProjections().stream()
        .collect(Collectors.toMap(
            ComuneProjection::getComPrgPk,
            ComuneProjection::getComDescrizione,
            (oldVal, newVal) -> oldVal
        ));
}

注意事项 #

• 原生查询的列别名必须和投影接口的getter命名严格对应，遵循驼峰命名规则（如下划线命名COM_PRG_PK对应别名comPrgPk，匹配getComPrgPk()方法）
• 若数据库表中COM_PRG_PK存在重复值，必须指定重复键的处理规则，否则会抛出IllegalStateException异常

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