如何直接从CrudRepository返回Map<Long, String>且无需投影或转换？

现有users表包含id、role、name字段，已定义继承CrudRepository<User, Long>的UserRepository。需要查询role='ADMIN'的所有用户的id和name，并直接以Map<Long, String>（键为id，值为name）形式返回。尝试以下@Query注解方法时抛出javax.persistence.NonUniqueResultException异常：

@Query("SELECT u.id, u.name FROM User u WHERE u.role = :role")
Map<Long, String> findIdAndNameByRole(String role);

请问：

1. 该需求是否可行？
2. 若可行，如何实现？
3. 是否可通过nativeQuery=true实现？

1. 需求完全可行 #

你之前报错是因为直接返回单个Map<Long, String>时，JPA默认会尝试把查询结果的第一行封装成Map，但当结果有多条时，它无法处理多行到单个Map的映射，因此抛出NonUniqueResultException。只要调整返回类型和处理逻辑，就能实现需求。

2. 实现方式 #

方式一：JPQL实现 #

方法A：返回结果数组后手动转换

修改Repository方法返回List<Object[]>，再在业务层转换成目标Map：

@Query("SELECT u.id, u.name FROM User u WHERE u.role = :role")
List<Object[]> findIdAndNameByRole(String role);

业务层转换逻辑：

List<Object[]> results = userRepository.findIdAndNameByRole("ADMIN");
Map<Long, String> idNameMap = new HashMap<>();
for (Object[] result : results) {
    idNameMap.put((Long) result[0], (String) result[1]);
}

方法B：用Stream API直接生成Map（推荐）

通过查询User对象（JPA会自动优化只查询所需的id和name字段），再用Stream收集成Map：

// 定义默认方法直接返回目标Map
default Map<Long, String> findIdNameMapByRole(String role) {
    return findUserByRole(role)
            .stream()
            .collect(Collectors.toMap(User::getId, User::getName));
}

@Query("SELECT u FROM User u WHERE u.role = :role")
List<User> findUserByRole(String role);

方式二：原生SQL（nativeQuery=true）实现 #

完全支持，逻辑和JPQL版本类似：

方法A：返回数组后转换

@Query(value = "SELECT id, name FROM users WHERE role = :role", nativeQuery = true)
List<Object[]> findIdAndNameByRoleNative(String role);

业务层转换逻辑和JPQL版本一致。

方法B：结合投影接口简化转换

先定义投影接口：

interface IdNameProjection {
    Long getId();
    String getName();
}

再用原生SQL查询返回投影集合，最后转成Map：

@Query(value = "SELECT id, name FROM users WHERE role = :role", nativeQuery = true)
List<IdNameProjection> findIdNameProjectionByRoleNative(String role);

业务层转换：

List<IdNameProjection> projections = userRepository.findIdNameProjectionByRoleNative("ADMIN");
Map<Long, String> idNameMap = projections.stream()
        .collect(Collectors.toMap(IdNameProjection::getId, IdNameProjection::getName));

3. 核心注意点 #

• 禁止直接返回单个Map<Long, String>：JPA无法自动将多行结果映射为单个Map，这是触发异常的根本原因。
• 投影和Stream的方式更简洁，能避免手动遍历数组的繁琐，同时代码可读性更高。

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